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(57) Abstract 

A computer network having a number of workstations running disparate operating systems and a file server having a tape driver for 
backup and restore of data on the network. The filter server runs a generic remote file system (GRFS) and workstations ran GRFS agent 
programs which allow the GRFS file system to access data within a workstation having a given GRFS agent program. The GRFS file 
system interfaces with each GRFS agent program via a command/response paradigm, with the messages being structured to support the 
disparate operating systems for backup and restore, to allow data to be interchanged between the disparate operating systems, and to allow 
independent multiple users of the network to request simultaneously backup or restore. 
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data area is at most 1,024 bytes. Furthermore, there are 
several fields within the DBLK structure, which are 
actually pointers to information within the DBLK data 
area. These pointers are generated as offsets from the 
5 beginning of the DBLK structure. For example, if the 
DBLK common area is 80 bytes long and the first item 
within the data area is the object's name, then the 
object name field would be set to 80 in order to point to 
the first byte following the DBLK common structure. The 

10 individual fields within the common DBLK structure that 
are manipulated by the GRFS agent programs are described 
in detail below under the heading "DBLK Fields". 

In order to implement a backup and restore function 
for a given computer 12, that computer 12 should 

15 advertise its capability for this purpose. Not every 
computer 12 in the network 10 is necessarily running a 
GRFS agent program so as to be able to have its data 
backed up. Consequently, the GRFS agent programs will 
"advertise" their capability as a GRFS agent over the 

20 network 10. This may be accomplished using the NRL 
resource advertisement function. The GRFS agent resource 
advertisement publishes the logical name of the 
particular agent's root DLE, as well as various flags 
which are used by the GRFS file system to control access 

25 to the GRFS agent. The format of the GRFS agent 
advertisement structure is as follows: 
struct grfs_ws_adver_struct 

CHAR major_ver; 
30 CHAR minor_ver; 

CHAR agent_type; 
CHAR flags; 

CHAR name [MAX_WORKSTATION_NAME_LEN] ; 

GRFS agents use character representations of the 
values in the version and flags fields. For example, the 
major. minor version of a particular GRFS agent might be 
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DATA BACKUP AND RESTORE SYSTEM POR 
A COMPUTER NETWORK 

BACKGROU ND OF THE INVENTTON 
Field Of the InvPnfinn 

The present invention relates to a system for 
protecting data through backup and restore operations, 
and more particularly to backup and restore software for 
protecting data which is processed on a computer network 

Description of th* Rglaj^d &rj; 

In order to ensure that original data stored on a 
medium such as a disk is not lost or damaged, a copy of 
that data is stored on another medium. Should the 
original data be lost or damaged, then the copy may be 
accessed to reproduce the original data. This process of 
copying and reproducing is generally known as backup and 
restore. Typically, original data are stored on a hard 
or floppy disk of a computer disk drive and are backed up 
to and restored from tape media of a tape drive. 

Backup and restore of the data are simple in a 
system that has a single standalone computer, having a 
given operating system and one or more disk drives, that 
interfaces with a tape drive system. A relatively simple 
backup and restore program can be used that interfaces 
with the computer operating system to backup data 
including files and directories stored on a hard disk to 
the tape drive and to restore such data from the tape 
drive onto the hard disk. 

Computer networks have evolved and this has placed 
greater demands on backup and restore systems. A 
computer network may include a number of computers each 
with its own hard and/or floppy disk drive, all of which 
are networked together on a common bus. For example, the 
computers on the network may include one or more 
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major version - o 
minor version = 0 
Unix agent 
user name required 
password required 
DLE name = " ONE_WOLF n 



10 



15 



20 



25 



30 



35 



Fig. 4 illustrates a sequence of GRFS command and 
response messages in simplified form to backup data on 
the tape drive TD of the file server FS. This Fig. 4 
gives the example of backing up a 5000 byte file named 
C0MMAND.COM which is stored on a "DRIVEC" of a given 
workstation named "DougCompaq". it is assumed that the 
given workstation WS has advertised over the network 10 
sufficient information so that the GRFS file system can 
create the first command message shown in Fig. 4 as 
ATTACH_DLE ( . 

To begin the 5000 byte backup, the workstation user 
will, via a given user interface 18, cause a display on 
a monitor M of devices and subdevices. The user will 
then select a given subdevice (e.g., DRXVEC in the 
example of Fig. 4) , resulting in the user interface 
displaying on monitor M names of various files and 
directories. The user will then select the file name to 
be backed up (COMMAND.COM in the example) resulting in 
the submission of a tape backup job for the file server 
FS in the network 10. 

Next, the sequence of GRFS file system command 
messages and GRFS agent response messages will occur as 
shown in order in the simplified Fig. 4. The sequence, 
as illustrated, commences with the GRFS command message 
ATTACH_DLE( naming "DougCompaq" (dle.id=0l) and completes 
with the final GRFS agent response message 
DBTACH_DLB_STAT() by which DougCompaq (dle.id=01) is 
detached. Thus, the file COMMAND.COM will be read from 
DRIVEC and written onto the tape drive TD of the file 
server FS for network 10. 
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obviously increases as more and more disparate operating 
systems are added to the network via the computers on 
which they run. 

In general, prior backup and restore systems for 
5 computer networks are limited to the number of different 
types of operating systems that can be supported. This 
places expansion limitations on the network in terms of 
adding computers running additional types of operating 
systems. Also, these backup and restore systems do not 
10 have the capability of interchanging data between 
different operating systems. Furthermore, bottlenecks 
occur and productivity is limited with prior backup and 
restore operations since multiple users cannot 
simultaneously request these operations. 
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SUMMARY o p THE INVENTION 

The present invention provides a backup and restore 
system for use on a computer network having computers 
running disparate operating systems. Backup and restore 

20 software has modules including a backup engine 
containing, among other components, a generic remote file 
system (GRFS file system) and GRFS agents, being loadable 
on a computer network having a plurality of computers 
including, for example, at least one file server and at 

25 least one workstation. The GRFS file system may run on 
one computer, e.g., the file server of the network, and 
each GRFS agent may run on another computer, e.g., a 
workstation,^ on the network. The GRFS file system 
running on the one computer, i.e., the file server in 

30 this example, is allowed to access a file system of the 
other computer via the GRFS agent on that other computer 
to backup and restore data on that computer. 

The GRFS file system and each GRFS agent interface 
with one another over the computer network by a set of 

35 defined messages. This messaging system is based on a 
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is used by the backup application's tape format module 
and is written to the backup media of tape device TD. A 
well-known Microsoft Tape Format Version i.o 
Specification describes stream header structures and also 
contains a list of pre-defined stream header id values. 
The size field must be set to the number of bytes 
contained in the succeeding data stream and should only 
be set in the first stream header structure for a 
particular data stream, i.e., if the stream header id 
value is 0, then the size field does not need to be set. 

An example is presented below of what a Macintosh 
GRFS agent would return in the GRFS_READ_OBJ_STAT 
messages when a file with a 2000 byte resource fork and 
a 4000 byte data fork is being backed up. This example 
also assumes that a GRFS data buffer limit is 1000 bytes. 
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40 



strm_header. id-STOM_MAC_RESOURCE 

strm_header.size=2000 
strnuheader. id=STREAM_INVALID 

stnnjieader . size=0 
strm_header . id=*STRM_NORMAL_DATA 
strm_header . size=2000 
stnnjieader. id=STREAM_INVALID 
stnnjieader . size=0 
strauheader . id=STREAM_INVALID 
stnnjieader . size»0 
stnnjieader. id«STREAM_INVALID 
stnn_header . size-0 



(returns 1st 1000 
bytes . of resource 
fork) 



(returns last 1000 
bytes of resource 
fork) 



(returns 1st 1000 
bytes of data fork) 



(returns next 1000 
bytes of data fork) 



(returns next 1000 
bytes of data fork) 



(returns last 1000 
bytes of data fork) 
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DESCRIPTIO N OP THE PREFERRED EMBODIMENTS 

Fig. l illustrates one example of a computer network 
10 which stores, manipulates, and otherwise processes 
data. The network 10 has a number of computers 12 which 
5 can communicate with one another over a network bus 14. 
In the example of Fig. l, the computers 12 include a file 
server FS and a plurality of workstations WS,, WS 2 , WS 3 , 
WS 4 , . . .WS n . Each of the workstations WS,-WS B has a display- 
monitor M and the workstations WS,-WS n include hard disk 
10 drives HDD) - HDD D . The file server FS has its own large 
file server disk drive FSDD and a tape drive TD upon 
which to backup to and restore from data on the network 
10. 

Every workstation WS r -WS n may be running the same 

15 operating system OS, or each workstation WS, through WS B 
may be running a disparate operating system, or there 
may be disparate groups of workstations with each group 
running the same operating system. For example, 
workstation WS, and workstation WS 2 may both be running 

20 the operating system known as DOS, workstation WS 3 may be 
running the operating system known as OS/2, workstation 
WS 4 may be running the operating system known as UNIX, 
workstation WS„ may be running the operating system known 
as Macintosh, and other workstations, not shown, or which 

25 may be added to the , network 10, may run the operating 
system known as Windows. Furthermore, the computers 12 
in the network 10 may be utilizing user interfaces such 
as those known as the DOS user interface, Windows 
graphical user interface, and a server-based NLM (NetWare 

30 Loadable Module) interface. 

The computer network 10 may be, for example, running 
the operating system software known as NetWare 3.X or 4.X 
which is produced by Novell, inc., of Provo, Utah. 
NetWare is designed to manage programs and data among the 

35 several computers 12 of the network 10. Fig. i also 
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alignment. The GRFS messages are defined with a n least 
common denominator" alignment that would apply to the 
above-noted major operating systems. Thus, for example, 
a given network 10 which may include workstations running 
5 only DOS, OS/2, and Macintosh, may be expanded to include 
a workstations running UNIX and/or Windows. In other 
words, the present invention supports a scalable network 
for backup and restore purposes from a small or 
departmental local area network (LAN) to a large or 

10 enterprise wide area network (WAN) . 

Furthermore, the message structure enables multiple 
users working at multiple computers 12 on the network 10 
to request simultaneously backup and restore of objects. 
This structure enables the GRFS file system to create a 

15 unique request id for every GRFS command message. 
Consequently, the GRFS file system can communicate 
simultaneously with multiple GRFS agents and, therefore, 
multiple users of the network 10 who at the same time 
want to have backup and/or restore operations performed. 

20 The present invention will manage these requests such 
that they are placed in a job queue in the file server 
FS, thereby allowing each user to operate independently 
from any other user on the network 10 and without waiting 
access to the backup and restore system. 

25 While each user can independently manage his/her own 

data on a given workstation, backup and restore of data 
on the entire network 10 can be centrally managed at a 
single location by, for example, a network administrator, 
from a given workstation or file server, or a system 

30 console. 

The remaining portion of this specification 
describes in much more detail the structure of the 
command/response messages, followed by a detailed 
description of the individual fields of the GRFS common 
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having the corresponding operating system in order to 
access the file system of that given computer. Thus, for 
example, the DOS GRFS agent 20 will run on a DOS 
workstation WS,, the OS/2 GRFS agent will run on the OS/2 
5 workstation WS 2 , etc. The package 16 also has a backup 
engine 22 running on the file server FS and includes a 
tape controller device driver and tape positioner to 
control the mechanical operation of the tape drive TD, a 
common file system, and at least one device specific file 
10 system. The latter is a GRFS file system which 
interfaces with GRFS agents 20 via messages described in 
more detail below. 

Fig. 3 illustrates the network 10, but modified to 
include the software 16. As shown, the backup engine 22 
15 is installed at the file server FS, while the DOS, OS/2, 
UNIX, and Macintosh GRFS agents are installed on the 
respective workstations WS r WS 2 , WS„ WS 4 , and WS D . In this 
example, the computer network 10 does not have a computer 
12 running a Windows operating system. Should the 
20 network 10 be expanded to include a Windows workstation, 
then the Windows GRFS agent of the software 16 would be 
installed at that workstation. While not specifically 
illustrated, a workstation user also can opt to have 
installed one of the user interfaces 18 for tape backup 
25 and restore purposes, that is the same as that already on 
a workstation for other purposes. 

As indicated above, a GRFS agent is a program which 
runs on a network computer such as the given workstation 
WS, and which allows the GRFS file system running on 
another computer, such as the file server FS, to access 
the file system within the given GRFS agent's computer. 
This access is accomplished by use of an interface 
between the GRFS file system and the given GRFS agent 
over the network bus 14. Specifically, the interface is 
35 defined by a set of GRFS messages which are documented in 
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SPECIFIC DESCRIPTION OF CO MMAND /RESPONSE MESSAGES 
3 -° Using GRFS Command and Response Messages 

This following sections provide the information necessary to 
implement each of the GRFS command and response messages. 

3.1 GRFS_ATFACH_DLE_, GRFS_ATTACH_DLE_STAT 

^r™^^^ 9 If ^ ?« si « vith the GRFS agent, the first 
^ n^T^^t backup application will send to the GRFS agent is 
the GRFS_ATTACT_.DLE command. The GRFS_ATTACH DLS command message 
contains the following parameters: " 96 

dle_name: This field contains the name of the DLE that the 
backup application desires to attach to. The die name 
field is encrypted in conjunction with the encryption 
done on the password field. The encryption/decryption 
method used by GRFS is described in the GRFS 
encryption section of this document. 

bec_flage: This field contains a bit-mapped value -which defines 
tne configuration options chosen by the backup 
application program. The values defined for use in 
this field are as follows: 

BEC_BACKDP_FILES_INUSE 0x01 

If this flag is set, then the GRFS agent should 
attempt to open files even if they are already 
in use by another process. 

BEC_EXTENDED_DATE_SUPPORT 0x02 

If this flag is set, then the backup application 
knows how to handle the ACCESS DATE and ARCHIVE 
DATE fields in the GRFS DBLK, so if the agent's 
OS platform supports these time -stamps, they 
should be provided in DBLKs. 

BEC_SBT_ARCHIVE_Fl4AG 0x04 

If this flag is set and the agent's OS platform 
supports an object "ARCHIVED" flag, then the 
GRFS agent should set an object's ARCHIVED flag 
after the object is closed during the backup 
operation . 

BBCJRESTORB_SBCORITY 0x08 

If this flag is set and the agent's OS platform 
has support for security specific data forks (ie 
ACL support for LANMAN OS/2), then security 
information should be restored during the 
restore operation. 

BEC_GET_HIDDEN_FILES 0x10 

This flag controls whether "hidden" objects 
2Ii«ir!L returned while processing 

GRFS_FIND_FIRST_OBJ and GRFS FIND NEXT OBJ 
commands. — — 
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retcode: This UINT16 field is used by GRFS status 

messages to hold the return code of the 
GRFS command. 

reguest_id: This UINT32 field contains a value which 
is generated by the GRFS file system for 
GRFS command messages and must be returned 
unchanged in the corresponding GRFS 
response message. 



In the detailed description of the specific GRFS 
messages below under the heading "Specific Description of 
Command/Response Messages", the number of parameters 
15 associated with a given GRFS agent is assumed not to 
include the above GRFS common message header. The 
messages use two major structures to define GRFS objects. 
These two major GRFS object types are a drive list 
element (DLE) objects, which are logical devices, and 
file system objects, which, are files and directories. 
The GRFS messages use DLE structures to reference drive 
list element objects and DBLK (descriptor block) 
structures to reference file system objects. 

A DLE is a structure that contains information about 
25 individual data storage devices which can be accessed for 
backup and restore. The DLE structure contains the 
following types of information: logical device name, 
access password, file system delimiter, etc. 

A DLE structure also supports a hierarchical 
30 structure. A DLB can be a "parent" DLE and can have 
"children" DLEs associated with it. For example, this is 
the case for a Novell server file system. For a Novell 
server, a DLE structure is created which is associated 
with the server and then DLEs for each volume on the 
35 server are created. The same situation can occur with a 
GRFS agent should that agent advertise or publish on the 
network 10 the workstation name as a DLB and then use 
children DLEs to advertise individual areas which can be 
accessed as logical units. 
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special_word: This field is not used. 

max_obj_bsize: This field contains the size of the buffer that 
the GRFS file system would like to use when 
transferring object data to/from the GRFS agent . 
This buffer size is the size of the object data 
buffer, not the size of the GRFS message buffer. 
GRFS message buffers are larger than the object 
data buffer size because the GRFS message buffer 
must include the 8-byte common header as well as 
the miscellaneous parameters <obj_id, 
stream_info, etc) used by the GRFS_WRITE OBJ, 
GRFS_VERIFY_OBJ, and GRFS_READ_OBJ~STAT 
messages. 

The GRFS object buffer size is a negotiated 
size, so if the value contained in the 
max_obj_bsize is larger than the agent would 
like, the agent can return a smaller value in 
the GRFS_ATIACH_DLB_STAT max obj_bsize field. 
The GRFS file system will use the value returned 
by the GRFS agent if it is smaller than the 
default file system object data buffer size. 

This field contains the DLB handle for the 
parent of the DLB being attached to if a parent 
DLB exists. If a parent DLB does not exist, 
then this field is set to 0. 

This field is not currently supported. 

This field contains the user name supplied by 
the backup application. This field will be 
filled only if the DLB is defined as requiring 
a user name. 

This field contains the password supplied by 
backup application if the DLB is defined as 
requiring a password. Even if the DLB requires 
no password, this field will appear to have a 
value until it is decrypted. Please see the 
section on DLB name/Password decryption for more 
information. 

The proper response message for a GRFS_ATTACH_DLE is the 
GRFS_ATTACH_DLB_STAT message. The parameters associated with the 
GRFS_DLB_ATTACH STAT message are described below. 



dle_parent : 



cmpr^type : 
user name: 



password: 



die id: 



max_connect6 : 



This field must be set to the DLB id which the 
GRFS agent wishes to use to identify the DLB. 
The DLB id is a 32 -bit value which the backup 
application will use in future GRFS coamands to 
identify the DLB to be operated upon. 
Typically, the GRFS agent will create DLB ids as 
a pointer to a structure of an index into an 
array. The DLB id can be any value except 0. 

This field should be set to the »"«*iFnim number 
of concurrent GRFS sessions which the agent is 
capable of. 
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data area is at most 1,024 bytes. Furthermore, there are 
several fields within the DBLK structure, which are 
actually pointers to information within the DBLK data 
area. These pointers are generated as offsets from the 
5 beginning of the DBLK structure. For example, if the 
DBLK common area is 80 bytes long and the first item 
within the data area is the object's name, then the 
object name field would be set to 80 in order to point to 
the first byte following the DBLK common structure. The 
10 individual fields within the common DBLK structure that 
are manipulated by the GRFS agent programs are described 
in detail below under the heading "DBLK Fields". 

In order to implement a backup and restore function 
for a given computer 12, that computer 12 should 
15 advertise its capability for this purpose. Not every 
computer 12 in the network 10 is necessarily running a 
GRFS agent program so as to be able to have its data 
backed up. Consequently, the GRFS agent programs- will 
"advertise" their capability as a' GRFS agent over the 
20 network io. This may be accomplished using the NRL 
resource advertisement function. The GRFS agent resource 
advertisement publishes the logical name of the 
particular agent's root DLE, as well as various flags 
which are used by the GRFS file system to control access 
25 to the GRFS agent. The format of the GRFS agent 
advertisement structure is as follows: 
struct grfs_ws_adver_struct 

CHAR major_ver; 
30 CHAR minor_ver; 

CHAR agent_type; 
CHAR flags; 



35 



CHAR name [MAX_WORKSTATION_NAME_LENJ ; 

GRFS agents use character representations of the 
values in the version and flags fields. For example, the 
major. minor version of a particular GRFS agent might be 
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1.3. so that agent would advertise the version numbers as 

-l- and "3", respectively. 

The GRFS major version number is used to control 
which GRFS agents can be accessed by the GRFS file 
system. The GRFS major version number of the GRFS file 
system and the GRFS agent must match exactly or no 
information of the existence of that GRFS agent will be 
given. The GRFS minor version number may be used for 
informational purposes only. 

The agent.type field is used to define the type of 
GRFS agent. For example, the following values may be 
defined for this field: 



DOS 
0S2 

MACINTOSH 
UNIX 



1 
2 
3 
4 



The GRFS flags field is a bit -mapped value with the 
following flags currently defined: 

GRFS_WS_PASSWORD_REQ 0x01 
GRFS_WS_USER_REQ 0 x02 

Combining all the GRFS resource advertisement fields 
leads to the following examples of GRFS agent 
advertisements : 



NRL Resource 

B 12 11RATB0Y_4 8 6 ■ 



Decode 



*1020SLEDGEHAMMER i 



major version « l 
minor version « 2 
DOS agent 

no user name required 

password required 

DLB name - "RATBOY_486* 

major version = i 
minor version «= o 
OS/2 agent 

no user name required 
no password required 
DLE name » "SLEDGEHAMMER 1 
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"0043ONE WOLF" 



major version - 0 
minor version = o 
Unix agent 
user name required 
password required 
DLE name = "ONE_WOLF" 
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Fig. 4 illustrates a sequence of GRFS command and 
response messages in simplified form to backup data on 
the tape drive TD of the file server FS. This Fig. 4 
gives the example of backing up a 5000 byte file named 
COMMAND.COM which is stored on a "DRIVEC" of a given 
workstation named "DougCompaq". it is assumed that the 
given workstation WS has advertised over the network 10 
sufficient information so that the GRFS file system can 
create the first command message shown in Fig. 4 as 
ATTACH_DLE ( . 

To begin the 5000 byte backup, the workstation user 
will, via a given user interface 18, cause a display on 
a monitor M of devices and subdevices. The user will 
then select a given subdevice (e.g., DRIVEC in the 
example of Fig. 4) . resulting in the user interface 
displaying on monitor M names of various files and 
directories. The user will then select the file name to 
be backed up (COMMAND.COM in the example) resulting in 
the submission of a tape backup job for the file server 
FS in the network 10. 

Next, the sequence of GRFS file system command 
messages and GRFS agent response messages will occur as 
shown in order in the simplified Fig. 4. The sequence, 
as illustrated, commences with the GRFS command message 
ATTACH_DLB( naming "DougCompaq" (dle.id-01) and completes 
with the final GRFS agent response message 
DETACH_DLB_STAT() by which DougCompaq (dle.id=01) is 
detached. Thus, the file C0MMAND.COM will be read from 
DRIVEC and written onto the tape drive TD of the file 
server FS for network 10. 
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Pig. 5 shows a sequence of GRFS command/response 
messages to restore information backed up on the file 
server FS of the network 10. m this example, it is 
assumed that a 5000 byte file named CONFIG.SYS has been 
backed up from a given workstation and is to be restored 
to DRIVEC of the workstation DougCompaq. After the 
workstation user has selected the file CONFIG.SYS using 
the user interface to select the file CONFIG.SYS for 
restore, the sequence of GRFS command/response messages 
will proceed as shown in Fig. 5. The sequence begins 
with the GRFS command message ATTACH_DLE( and completes 
with the GRFS response message DETACH_DLE_STAT ( ) The 
file CONFIG.SYS will be read from the tape drive TD and 
restored onto DRIVEC. 
15 as mentioned previously, the command/response 

messages are structured such that objects such as files 
and directories may be backed up from a GRFS agent 
running one operating system, e.g., OS/2, and restored to 
a GRFS agent running another operating system, e.g., DOS. 
20 This is accomplished by the messages containing a 
structure GRFS_STREAM_INFO . This structure has the 
following definition: 

Struct GRFS_STREAM_INFO i 
25 UNET32 id; 

* UNET16 fs_attrib; 

3££f tf.attrib; 
UNET64 size; 

30 when the backup application is reading an object 

the GRFS_READ_OBJ_STAT response message contains a 
GRFS_STREAM_lNFO structure. The GRFS agent program must 
set the id field of the first GRFS_READ_OBJ_STAT response 
message of each individual data stream to the appropriate 

35 value for the agent's particular operating system 
Succeeding GRFS_READ_0BJ_STAT messages for the stream 
nnist have the stream header id field set to 0 
(STREAM_ INVALID) . The data in the stream info structure 
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is used by the backup application's tape format module 
and is written to the backup media of tape device TD. A 
well-known Microsoft Tape Format Version i.o 
Specification describes stream header structures and also 
contains a list of pre-defined stream header id values. 
The size field must be set to the number of bytes 
contained in the succeeding data stream and should only 
be set in the first stream header structure for a 
particular data stream, i.e., if the stream header id 
value is 0, then the size field does not need to be set. 

An example is presented below of what a Macintosh 
GRFS agent would return in the GRFS_READ_OBJ_STAT 
messages when a file with a 2000 byte resource fork and 
a 4000 byte data fork is being backed up. This example 
also assumes that a GRFS data buffer limit is 1000 bytes. 



strm_header . id«STRM_MAC_RESOURCE 

strm_header . size=2000 
strm_header . id=STREAM_INVALID 

strm_header . size=0 

strm_header . id=STRM_NORMAL_DATA 
strm_header.size=2000 

strm_header . id»STREAM_lNVALID 
strm_header . size=o 

strm_header . id=STREAM_INVALID 
strm_header . size-0 
strm_header . id=STREAM_INVALID 
strm_header . size=-0 



(returns 1st 1000 
bytes . of resource 
fork) 



(returns last 1000 
bytes of resource 
fork) 



(returns 1st 1000 
bytes of data fork) 

(returns next 100 0 
bytes of data fork) 

(returns next 1000 
bytes of data fork) 

(returns last 1000 
bytes of data fork) 
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When the backup application is restoring an object, 
the GRFS commands (GRFS_WRITE_OBJ, GRFS_VERI FY_OB J ) will 
also contain a GRFS_STREAM_INFO structure. The GRFS 
agent must examine the stream header id value to 
determine whether the data stream type is supported on 
the agent's operating system platform. if the data 
stream type is not supported the GRFS agent should set 
the response message retcode to FS_DONT_WANT_STREAM. 
This will cause the backup application to skip to the 
next data stream or the next object if at the last data 
stream for a particular object. For instance, if an 
object was backed up from an OS/2 agent which supports a 
normal data stream, an extended attribute (EA) data 
stream, and an access control list (ACL) data stream, 
then if the object is restored to a DOS agent, the DOS 
agent will return FS_DONT_WANT_S TREAM when it receives 
GRFS_WRITE_OBJ commands with stream header , id values that 
indicate either EA or ACL data streams are being restored 
since this data is not supported by DOS. The DOS agent 
will accept the normal data stream which it does support. 
Thus, this functionality allows objects to be backed up 
from an agent running on one operating system and 
restored to an agent running on another operating system. 

As also mentioned above, the message structure is 
defined as well, such that backup and restore can be 
supported with respect to most operating systems, 
including the current major operating systems which are 
DOS, OS/2, Ijacintosh, Windows, and UNIX. Each operating 
system will have its own data structures aligned 
differently from one another. For example, one operating 
system may have a l-byte alignment where a data byte may 
be placed anywhere, whereas another operating system may 
have a 2 -byte alignment where a data byte may be placed 
in either an even or odd byte location. Other operating 
systems, for example, may have what is known as a 4 -byte 



- 16 - 



WO 95/13580 



PCT/US94/12915 



alignment. The GRFS messages are defined with a "least 
common denominator" alignment that would apply to the 
above-noted major operating systems. Thus, for example, 
a given network 10 which may include workstations running 
5 only DOS, OS/2, and Macintosh, may be expanded to include 
a workstations running UNIX and/or Windows. In other 
words, the present invention supports a scalable network 
for backup and restore purposes from a small or 
departmental local area network (LAN) to a large or 
10 enterprise wide area network (WAN) . 

Furthermore, the message structure enables multiple 
users working at multiple computers 12 on the network 10 
to request simultaneously backup and restore of objects. 
This structure enables the GRFS file system to create a 
15 unique request id for every GRFS command message. 
Consequently, the GRFS file system can communicate 
simultaneously with multiple GRFS agents and, therefore, 
multiple users of the network 10 who at the same time 
want to have backup and/or restore operations performed. 
The present invention will manage these requests such 
that they are placed in a job queue in the file server 
FS, thereby allowing each user to operate independently 
from any other user on the network 10 and without waiting 
access to the backup and restore system. 
25 While each user can independently manage his/her own 

data on a given workstation, backup and restore of data 
on the entire network 10 can be centrally managed at a 
single location by, for example, a network administrator, 
from a given workstation or file server, or a system 
30 console. 

The remaining portion of this specification 
describes in much more detail the structure of the 
command/response messages, followed by a detailed 
description of the individual fields of the GRFS common 

35 
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DBLK structure which may be manipulated by GRFS agent 
programs . 
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SPECIFIC DESCRIPTION OF rn^ ND /RESPONSE MESSAGES 

3.0 Using GRFS Command and Response Messages 

This following sections provide the information necessary to 
implement each of the GRFS command and response messages. 

3.1 GRFS_ATTACH_DLE_, GRFS_ATTACH_DLE_STAT 

rnVJ^Si^^ 5? " RL °* 8ei <? n with ^ GRFS agent, the first 
GRFS command the backup application will send to the GRFS aoent is 
the GRFS^ATTACH DLB command. THe GRFS_ATTACH DLB command message 
contains the following parameters: ~ 96 

dle_name: This field contains the name of the DLE that the 
application desires to attach to. The die name 
field is encrypted in conjunction with the encryption 
done on the password field. The encryption/decryption 
method used by GRFS is described in the GRFS 
encryption section of this document. 

bec_flag a : This field contains a bit-mapped value which defines 
tne configuration options chosen by the backup 
application program. The values defined for use in 
this field are as follows: 

BBC_BACKDP_FILES_INUSB 0x01 

If this flag is set, then the GRFS agent should 
attempt to cpen files even if they are already 
in use by another process. 

BEC_EXTENDED_DATB_SUP PORT 0x02 

If this flag is set, then the backup application 
knows how to handle the ACCESS DATE and ARCHIVE 
DATE fields in the GRFS DBLK, so if the agent's 
OS platform supports these time- stamps, they 
should be provided in DBLKb . 

BEC_SET_ARCHTVE_FIiAG 0x04 

If this flag is set and the agent's OS platform 
supports an object "ARCHIVED" flag, then the 
GRFS agent should set an object's ARCHIVED flag 
after the object is closed during the backup 
operation . 

BEC_RESTORE_SECURITY 0x08 

If this flag is set and the agent's OS platform 
has support for security specific data forks <ie 
ACL support for LANMAN OS/2), then security 
information should be restored during the 
restore operation. 

BEC_GET_HIDDENJTLES 0x10 

This flag controls whether "hidden" objects 
r^S^ir^ °t returned while processing 
GRFS_FIKD_FIRST_0BJ and GRFS_FIND_NEXT OBJ 
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BBC_GET_SYSTEM_FILES 0x20 

This flag controls whether "system" objects 
should be returned while processing 
GRFS_FIND_FIRST_OBJ and GRFS FIND NEXT OBJ 
commands . ~~ — 

BEC_PROC_EMPTY_DIRS 0x40 

This flag controls whether directories which are 
empty should be returned while processina 
GRFS_FXMD_FXRSTOBJ and GRFS_FIND NEXT OBJ 
commands . — 
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spe ci al_wor d : 
max_ob j_bsize : 



This field is not used. 

This field contains the size of the buffer that 
the GRFS file system would like to use when 
transferring object data to/from the GRFS agent. 
This buffer size is the size of the object data 
buffer, not the size of the GRFS message buffer. 
GRFS message buffers are larger than the object 
data buffer size because the GRFS message buffer 
must include the 8-byte common header as well as 
the miscellaneous parameters (obj id, 
stream_info, etc) used by the GRFS_WRITE OBJ, 
GRFS_VERIFY_OBJ, and GRFS READ OBJ~STAT 
messages. OT "~ ~~ 

The GRFS object buffer size is a negotiated 
size, so if the value contained in the 
*nax_objJbsize is larger than the agent would 
like, the agent can return a smaller value in 
the GRFS_ATTACHJ)LE_STAT max_obj_bsize field. 
The GRFS file system will use the value returned 
by the GRFS agent if it is smaller than the 
default file system object data buffer size. 

This field contains the OLE handle for the 
parent of the DLB being attached to if a parent 
DLB exists. If a parent DLE does not exist, 
then this field is set to 0. 

This field is not currently supported. 

Th±B field contains the user name supplied by 
the backup application. This field will be 
filled only if the DLB is defined as requiring 
a user name. 

This field contains the password supplied by 
backup application if the DLB is defined aB 
requiring a password. Even if the DLB requires 
no password, this field will appear to have a 
value until it is decrypted. Please see the 
section on DLB name/Password decryption for more 
information. 

The proper response message for a GRFS ATTACH DLB is the 
^f-£??^ D £-?^ ******* • The parameters'" associated with the 
GRFS_DLB_ATTACH_STAT message are described below. 

dle_id: This field must be set to the DLB id which the 

GRFS agent wishes to use to identify the DLB 
The DLB id is a 32 -bit value which the backup 
application will use in future GRFS commands to 
identify the DLB to be operated upon. 
Typically, the GRFS agent will create DLB ids as 
a pointer to a structure of an index into an 
array. The DLB id can be any value except 0. 



dle_parent : 

cmpr_type : 
user_name : 

password: 



max connects: 



This field should be set to the maximum number 
of concurrent GRFS sessions which the agent is 
capable of. 
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max_opens j>er_connect : This field should be set to the maximum 

number of objects which can be opened 
simultaneously per GRFS session. 



process -ddbs: 
max_obj_bsize: 



crop r_ type : 
supports_children : 



path_len: 



curxent_path : 



This field is not currently supported. 

This field should be set to the maximum object 
data buffer size the agent wishes to use. The 
maximum GRFS message size is greater than the 
maximum object data buffer size because of the 
additional parameters in the GRFS messages which 
convey object data. 

This field is not currently supported. 

This field is a BOOLEAN flag which should 
be set to 0 if the DLB does not support 
children. A non-zero value declares the 
DLB as supporting children DLBs . A DLB 
declared as supporting children DLBs 
CANNOT support file system objects as 
?\ 1:ner a DLB supports children 
DLBs or file system objects.' Never both. 

This field should be set to the length of the 
string (including the '/0' terminator) returned 
in the current_path field. Current GRFS agent 
implementations will always start in the logical 
root directory of DLBs when they are attached 
so the current jath field should always be set 
to and the path_len field set to if 

Tfcis field should be set to the current path of 
the DLB being attached to. As described above 
at DLB attachment time, the current path will b4 

^ e J^? XCa , X 7** of the DLE ' *° the current path 
is empty (**) . 
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3.2 

GRFS_FIND_FIRST_DLE , GRFS_FIND_NKXT_DLE , GRFS_FIND_DLB STAT 

w e .K RF K- F 5. ND - F1R ? T - DLE and GRFS_FIND_NKXT OLE commands are used 
dL « th^h Jt o aP £^ Catl i 5n P r °9 ram to enumerate children DLBs for 
DLBs which are declared as supporting children DLBs. The sole 
parameter associated vith these two commands is the Tale il 
parameter. The backup application will supply the die id value 
which was previously returned by a GRPS_ATTACH DLE STAT~ response 
message. The GRFS agent should respond with a GRFS~FIND DLK STAT 
message to both the GRFS_PIND_FIRST_DLE and GRFS~FIOT~NEXT_DLB 

It is the responsibility of the GRFS agent to determine the 
^ eP traCk ° f the <*il^en DLBs as they a^beiS 
enumerated. The parameter in the GRFS FIND DLE STAT response 
message are described below. ~ - - response 

dle_name: This field should contain the name of DLE which is 
being enumerated. The value must be a null -terminated 
string . 

path_delim: This field should contain the ASCII code of the 
character used by the agent's file system. 

passvd_req: This field is a boolean flag and should be set to 0 if 
no password is required to attach to the OLE. A non- * 
zero value in this field indicates that a password is 
requared. 

user_req: This field is a boolean flag and should be set to 0 if 
no user name is required to attach to the DLB. A non- 
zero value in this field indicates that a user name is 
required in order to attach to the DLE. 

dle_wri table: 

This field is a boolean flag used to indicate whether 
restore operations are permitted on the DLB. Setting 
™ J^ u * 0 Prevent the backup application 

from attempting restore operations. 

1 as t_accesB_supported : 

^ S ™ ld i/J a boolean fla 9 U8ed to indicate whether 
tne DLB s file system supports the last access date 
information. This field is used by the Backup 
application to determine whether file -grooming is 
supported for this device. 9 

os_id: 

os_ver: 

fs_type: 

cryp_type: This field is not currently used. 
cmpr_type: This field is not currently uBed. 

more_flag: This field is a boolean flag and should be used by 
GRFS agents to indicate that the DLB being returned is 
the last child DLB available. If the GRFS agent is 
incapable of knowing ahead of time whether this is the 
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last DLB, then this field can always be set to a non- 
zero value (TRUE) . This will force the backup 
application to sent GRFS FIND NEXT DLE commands until 
the GRFS agent responds with a~FS_NO_MORB return code 
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3 - 3 GRFS_DETACH_DLE , GRFS_DBTACH_DLB_STAT 

I*?* ^ RF 1 S ^ D f I ' ACH - D ^ B COMnand iB ««ed by the backup application when 
it no longer needs to access a DIE. The message has only one 
command specific parameter, the dle_id of the DLE which the backup 
application wishes to detach from. DLBs will always be detached 
fJ^Z* °^ e w t0 Which they were attached, in other words 
t £ ^ Wa ° attached to the first to be 

detached from. When a DLE is detached, the GHPS agent can free 
" 8 °" rCes associated with the attached OLE. The 
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3.4 

GRFS_FIKD_FIRST_OBJ, GRFS_FIND_NEXT_OB J , and GRFS_FIND_OBJ_STAT 

JSl^f™ application uses the GRFS FIND FIRST OBJ command to 
begin scanning for file system objects. GRFS agents must take 

hSddS? and" cvctto^ camnand. These flags specify whither 
hidden and SYSTEM ejects should be returned f or 
GRFS_FIND_FIRST_OBJ and GRFS FIND NEXT OBJ conronSsT Se 
parameters associated with find f irst~canmand are explained below 

dle_id: This field contains the id of the DLB that the backup 
application wishes to scan. 

find_type: This field contains one of these values: 

0x00 -return all object types found 

0x01 -return only directory objects found 

sname: This field contains the search strina Qualifier 

Normally this field will contain the string-?^ 
string »*.*• means that all objects that meet the 
find_type criteria should be returned. 

3.4.1 GRFS Agent Path Generation 

When a GRFS agent is creating the path string used for its file 
"PindFirst- system call, the following SS»Ss 2L?bI 
included to create the correct path string. The oath BtrinT™,,^ 
begin with the base directory of the DLE The DLBb c^en? 

11 ^rZ^tS 0 th t Pat * i 8tring - PinaUy theiname^axan^S 
V° ^! Path strin 9- GRFS agent must also supply 

path delimetera wherever required. An example of a -FindFirst- 
path string created by the OS/2 GRFS agent is presented telcV: 

DLE base path: "C:\DOCS" 
DLE current path: "GRFS\DESIGN" 
sname: »*_*• 

The GRFS agent creates the path string: "C:\DOCS\GRFS\DBSIGN\«.*» 

lOE^L'f* re 5> on8i ble for keeping track of when path delimiters 
must be inserted. For example when OS/2 GRFS agent publishes tte 

DLB base path: »C:\" 

DLB current path: "DOCS\GRFS\DBSIGN» 



GRFS agent creates the path string: "C:\DOCS\GRFS\DESIGn\*.*" 

^k°2T S a 9 ent v doe 5 insert a path delimeter after the DLB base 
path because the DLB base path already ends with a path delimeter 

3.4.2 GRFS Find Info Area 

One of the most important fields in the GRFS DBLK data area is the 
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Find Info area. Operating systems usually require some data which 
was returned from a FindFirst operation in order to perform 
subsequent PxndNext operations. GRFS is designed so that the Find 
info will resxde in the GRFS DBLK, and the Find Info will be 
available to the GRFS agent whenever the GRFS FIND NEXT OBJ 
command xs issued. This is accomplished by passing "the DBLK 
containing the Find Info back and forth between the backup 
application and the GRFS agent. F 
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The backup application will never modify the Pind Info data area. 

Hie GRFS_PIKD_NEXT_OBJ message has only two parameters: 

dle_id: This field contains the id of the DLB that the backup 
application wishes to continue scanning. ^ 

dbl)C: ™^ltV d / S * Which c °»taine the Find Info data 

oration. a98nt t0 perform a Pin«JNext 

The GRFS agent must respond with a GRFS FIND OBJ STAT resnanse 
message to both the GRFS_FIND_FI RST_0BJ and the gSs"?^ NEXT OB J 
devoid bel^f: parameterB * ith *° this response" message "are 

more_flag: This field contains a boolean value that can be used 
3k S e *f agent to indicate to the GRFS file system 
whether there are any more objects available after the 
object currently ^being returned. If the more flag is 
(FALSE), then the next time the" backup 
«i 1<m m ^ CeS a.f^extObject function call, the 
GRFS file system wall immediately return FS NO MORE 
f° n0t a tranemit GRFS FIND NEXT OBJ command to 

?£J™ S <t ge ?*- " the agent is unable to know in 
advance if the object being returned is the last 
object available, then the a|ent can always set this 
™ C e d **° a non * zero (TROB) value. This will force the 
~~!% Btem to aend a GRFS PIND NEXT OBJ cccmand 
vtlu? 6 agent to respond with a FS_NO~MORB return 

dblk: This field must be a complete GRFS DBLK. if a 

directory object xs being returned, then the directory 
name should be a full path relative to the DLBs base 

ffi/toSW^ " • CUrrent Path a DLB is 
-n£cS^?w *** w a9en? 18 ^turning the directory 
JZSFL ^v™^ 1 retumed " the DBLK data area 
"0S2\sySTBM\TRACE- . The path must be null- 
inS^fS ?t the null-terminator character must be 
~ - pa . len ?th field in the DBLK common 
SjfSl^ Root di rectory object B a,.,. ret umed with 
the path name '\0' and the path-leng field set to 1. 



File object names are also returned as null -terminated 
strings, but only the actual file name is returned. 
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3.5 GRFS_FIND_CLOSB and GRFS_FIND_CLOSB_STAT 

The GRFS FIHDCLOSB command is used by the backup application when 
it is done scanning a particular directory. When a GRFS agent 
receives a GRFS_FIHD_CLOSB message, the agent is allowed ill 
£■ *, ny resources associated with the 

^^irst/FindNextf unctions " are two parameters in thl 

GRFS_FIND_CLOSB message and they are described below: 

dle_id: 
dblk: 

Vl B £?J^™Z B !£^ B ~™* B Z2* type for the GRFS FIND CLOSE command 
is the GRFS Fp© CLOSB_STAT message. There are "no parameters 
associated with the GRFS FIND CLOSE message 
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3.6 GRFS_GET_OBJ_INFO, GRFS_GBT_OBJ_IHFO_STAT 

The GRFS_GET_OBJ_INFO command i B used by the backup application to 
retrieve a completed DBLK when the backup application has only a 
partially complete DBLK. The only DBLK fields which are required 
»°. C ^ a t n v V t lld data when the DBLK is passed to the GRFS agent 
are the blk_type (DIR or FILE) and the object name in the DBLK 
data area. The proper response message tvoe in 

GRFS_GET OBJ INFO STAT . The only parameter in 9 the ^response 
message is the fully completed DBLK. response 

There is one slight difference between how a DBLK is created for 
the GRFS_GBT_OBJ_INFO command. All other GRFS canwds which 
create DBLKs return a fully specified path as the object name for 
directory objects. The GRFS_GET_OBJ INFO STAT DBLK returns ONLY 
S e a^^ShV ^ aB the Path ** t& in thi DBLK data area. This 

**** It the w DBLK 8ent to the agent contains a Find Info area 
then the agent MUST preserve this data within the DBLK which 
is returned to the backup application. 
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3.7 GRFS_GBT_CDRRENT_DDB, GRFS_GET_CDRR£NT_DDB_STAT 

The GRFS^GET_CORREOT_DDB command is used by the backup application 
«.if et ^i eVe a DBLK corresponding to the DLEs current directory 
path. The proper response message type is GRFSJ3ET OBJ INFO STAT 
The directory path string returned in the DBLK must "be a~fullv 
specified relative to the DLB's base path. An example is 
presented below: -^«V-Le is 

DLB's base path: "C:\OS2" 

DLB's current path: "WINOS2\SYSTEM" 

The path string returned in the DBLK data area would 
"WITOS2\SYSTBM". An example of the DLB's current "Ith £ilg tnl 
logical root directory is presented below: 3 

DLB's base path: "C:\OS2" 

DLB's current path: ** 

7^1 p 5*? " ri f * data returned in the DBLK data area would be a 
'\0' and the b.d.osjpath_leng field would be set to 1. 

^^r^rt 6 ^ S ™r 9 ^ n I returnB a logical root directory 
?^ect DBLK, the DBLK data area path string should be set to 
'\0' and the b.d.os_path_leng field should be l. 
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3 - 8 GRFS_CRKATE_OB J , GRPS_CREATE_OBJ_STAT 

^ ^»-i; RKATE - OB J P° oma f ld iB by the backup application 

during restore operations in order to create a file system object 
The parameters associated with this command are the following: 

dle_id: This parameter contains the DLE handle of the DLB 
where the object should be created. 

dblk: This Parameter is a complete DBLK and contains the 

type and the name of the object to be created. 

Directory object OBLKs will contain fully specified paths, so the 
«K^ e ? t II th iB "2 1 include <* »hen creating thef ull pa?h of 
2? ^vli,, 6 ^ 0 ^' 3 ' ^ Agents must be capable of creating 
©£s <^£oL r™£ 8 P ecified di^ctory path from a single 
=^^-^v?^ ~ ^ command. For example, the backup application may 

If the any of the directories -DOCS", •WORD-, or "WIR31" do not 
already exist, then the agent must first create the nr»™^n! 
directories within the fully specified path ^ P recedin 9 

directory 6 " 8 "** * lWYB created in DLB's • current path 

The proper response message type is GRFS CREATE OBJ STAT There 
are no parameters associated with thie response 'meeSkge 
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3.9 GRFS_OPEN_OBJ, GRFS_OPEN_OBJ_STAT 

^ ba ^/^ >liCat A° n muBt "°P en " a file system object before any 
read, write or verify operations can be performed on the object 

delcrifaea a8BOciated wi <* the GRFS_OP£N_OBJ command are 

dle_id: This field contains the OLE handle of the DLK where 
the object to be opened resides. 

mode: This field contains a flag value which is GRPS agent 

must use to determine the mode which should be used to 
open the object. This value will be one of the 
following: 

0 READ mode (backup operation) 

1 write mode (restore operation) 

2 VERIFY mode (compare operation) 

dblk: This parameter is a complete DBLK and contains the 

type and the name of the object to be opened. 

When a backup application is backing up a GRFS agent, the backuo 
?E Pl ™ l0n may da,,i » to baeku P f vhich are already in usfo^ 
w fSL*?^ 8 Th * B*C_BACKOP_FILES 1NDSB flag in ti£ 

rhl-G^I \ltlr d J? G Jf S - ATrACH - DLB command determines whether^ 
™L a r£5 attempt to open objects which have already 

been opened by a different process. If the DLS is configured to 
Sf^ l X c leS Xn USe the a 9 ent « able to open the object the£ 

fsopSS iS on8e TC8Ba9e retura code 8hould be 



set to 



When an object is opened successfully, two parameters are returned 

is the ob 3 id. This parameter is a 32 -bit value generated by the 
wnfL a I^ "J" pbiact handle. All succeeding GRPS T coZands 
£3?. ^ e . e ob:,ect wil1 reference the obj id. As withSli 

SSate^e o^ct^dTe S5. ^ de8i " d to 

A completed DBLK is also returned to the backup application in the 
response message. If the GRPS agent's operatinT«WemTlaMorm 
*5°?"° S "P^ic object attributes w^Lch «e 22S?lfi' oS? 
after the object has been successfully opened, they can be savad 
if SS/S.'S^ 1 ^ 8X88 Within ^ DB ^'s^ata area y toelxamplj 
if opened ■longnames" are accessible only after the^bject 
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3.10 



GRFS_READ_OBJ, GRFS_R£AD_OBJ_STAT 



The backup application uses the GRFS_READ_OBJ command to read data 
from previously opened file system objects. The parameters 
associated with this command are described below: 



obj_id: 



size : 



offset: 



This field contains the object handle id which was 
returned by the agent in the GRFS OPEN OBJ STAT 
response message. ™ ~ 

This field contains the size (inSpl230Xbytes) buffer 
which is available to receive data. The GRFS agent 
should endeavor to return as much data as possible for 
each GRFS_READ_OBJ command. 

This field contains the number of bytes offset into 
the object the agent should begin returning data from. 



The proper response message type is GRFS READ OBJ STAT 
response message has four fields which are described "below: 



The 



size: 



blk size: 



strm_info: 



data: 



This field should contain the actual number of bytes 
of data being returned in the response message. 

This field should usually be set to 1. This field is 
used by GRFS agents to request a specific number of 
bytes to be read by the next GRFS READ OBJ command. 
This functionality can be used if certain data areas 
must be read as "atomic" objects. 

As an example, suppose the backup application requests 
to read 20 bytes. The GRFS agent has 14 bytes 
available, and then the next 12 bytes must be read a 
unit. The GRFS would return the 14 bytes, set the 

Si? e f f?£ d to 14 ' ^ Bet blkaiM field to 12. 
This will force the backup application to request 12 
bytes in the next GRFS_RBAD_OBJ command. 

The GRFS agent must never set the blk size field 
larger than the negotiated GRFS maximum obiect buffer 
size . 

This field is a STREAM_XNFO structure and is discussed 
in section 1.3 of this document. 

This field is the buffer which contains the actual 
data. The size of this buffer is limited to the 
maximum object buffer size as negotiated during the 
DLB attach operation. 
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3.H GRFS_WRITB_OBJ, GRFS_WRITE_OBJ_STAT 

The backup application uses the GRFS_WRlTE_OBJ command to restore 
data to a GRFS agent . The parameters associated with this command 
are descrxbed below: 



ob}_id: This field contains the object handle id which was 

returned by the agent in the GRFS_OPEN_OBJ STAT 
response message. 

size: This field contains the size (in bytes) of the data 

buffer which is to be written. 

offset: This field contains the offset in bytes, from the 
beginning of the object, that the GRFS agent should 
begin writing the data buffer. 

strmjinfo: This field contains a STREAM INFO structure. As 
described for the GRFS_READ OBJ~response message, the 
first block of each data stream will have the 
strm_info.id field set to the stream data type. All 
succeeding blocks of that data stream type will have 
the strm_info.id field set to STRM INVALID. The first 
block of a particular stream data" type will have the 
strm_info.size field set to the total size (in bytes) 
of the stream. 



GRFS agents should ignore a data block for a stream 
type that they do not recognize, and their response 
message should indicate that the entire block was 
successfully written. 

data: This field is the buffer which contains the data block 

that is to be written. . 

The proper response message type is GRFS_WRITE_QB J_STAT . This 
response message has the following parameters associated with it: 

size: This field should be set to the number of bytes 

successfully written. 

blk_eize: This field should normally be set to 1. This field is 
used to indicate that the GRFS agent requires a 
specific number of bytes to be written in the next 
GRFS_WRTTB_QBJ command. Any value other than 1 will 
force the backup application to attempt to write the 
request ed number of bytes during the next 
GRFS_WRITB_OBJ operation. The agent should NEVER set 
this field to greater than the negotiated maximum 
object buffer size. 
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3.12 



GRFS_VERIFY_OBJ, GRFS_VERI FY_OBJ_STAT 



™f , b *f*" p application uses the GRFS VERIFY OBJ command to verify 

Sihf S5*£S? d baCkUP media mat5hes the data redoing 

ale^esSdTeTow: ^ paramete " "sociated with this command 

obj.id: This "eldcontains the object handle id which was 
returned by the agent in the GRFS OPEN OBJ STAT 
response message. - - - 

£iC u d 5 ontaina the "i*e (in bytes) of the data 
buffer which is to be compared. 

This field contains the offset in bytes, from the 
beginning of the object, that the GRFS agent should 
begin comparing the data buffer. 

f K ie \ ld contains a STREAM INFO structure and is 
described in section 1.3 of this document. 

Sat is el to be t ri S d er ^ 

The proper response message type is GRFS VERIFY OBJ STAT Th-io 
response message has the following paramet-^a^bc^e^wkth^tf 

size: This field should be set to the number of bytes 

successfully verified. ot oytes 

™i* " eld . **?ul<l normally be set to 1. This field is 
U ^ d *° indicate that the GRFS agent requires a 

IHI vERIFY^ ?L%£° 1° *° 1 verifi8d i» the nex? 
uxi«^_vBRiFY_OBJ command. Any value other than l vin 
force the backup application to attempt to vtrir/S£ 

™^ ?t m ^ a9cnt 8hould NBVBR set this field 
sizlT n ©90tiated maximum object buffer 



size: 



offset; 



strm^info: 



data: 



blk size: 



PMcnnrtn- *wn ococ<vn>. . . 
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3.13 GRFS_SEEK_OBJ, GRFS_SEEK_OBJ_STAT 

The backup application uses the GRFS_SEEK_OBJ command to force the 
GRFS agent to move the previously opened object's file location 
pointer to a specific offset within the object. This command is 
typically used by the backup application to seek past sectors 
whach are unreadable in hopes that some of the data may be 
readable (HaHa) . The parameters associated with this command are 
described below: 

obj_id: This field contains the object handle id- which was 
returned by the agent in the GRFS_0PEN OBJ STAT 
response message. ~~ "~ 

offset: This field contains the offset in bytes, from the 
beginning of the object, that the GRFS agent should 
move the file pointer to. 

The proper response message type is GRFS_SEEK__OBJ_STAT . Tnis 
response message contains only one parameter associated with it 
The parameter, seek_obj_of f set specifies the offset within the 
object that the agent was able to seek to. 
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3 - 14 GRFS_CLOSE_0B J , GRFS_CLOSE_OBJ_STAT 

The backup application uses the GRFS_CLOSB_OBJ command to force 
toe GRFS agent to close a previously opened file system object. 
When an object is closed, the agent is allowed to free any 
resources associated with the open object. The only parameter in 
this command message is the obj_id field. This field contains the 
object handle id which was returned by this agent in the 
GRFS_OPEN_OBJ_STAT response message. 

The proper response message type is GRFS CLOSE OBJ STAT. There 
are no parameters with this response message. ~ " 
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3.15 GRFS_DELETE_OBJ, GRFS_DELETE_OBJ_STAT 

The GRFS_DELBTB_OBJ command is used by the backup application 
during transfer operations in order to remove a file system 
object. The parameters associated with this command are the 
following: 

dle_id: This parameter contains the DLE handle of the DLB 

where the object should be removed. 

dblk: This parameter is a complete DBLK, and contains the 

type and the name of the object to be deleted. 

*p905Xfully Directory object DBLKs will contain specified paths, 
so the DLB' s current path is NOT included when 
creating the full path of the object to be deleted. 
The backup application will first remove file objects 
from a directory object before removing the directory 
object. 

Pile objects are always deleted from the DLB' s current 
path directory. 

The proper response message type is 
GRFS_DELBTE_OB J_STAT . There are no parameters 
associated with this response message. 
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3 16 GRFS_CHANGE_DIR # GRFS_CHANGEJDIR_STAT 

The GRFS OIANGE_DIR command is used by the backup application to 
™« Ce *J?* 8 a9ent to cnanse the "current directory- of a specific 
•j-. 1 ^? new path su PPlied in the message is always a fully 
552£ i£ie *- pat £ relative to the DLE'b base path. The GRFS agent 
MOST verify that the new path is a valid path. This can usually 
be acconqplxshed by performing a "PindPirst" operation on the new 
path. As an added bonus, the backup application may send a -null- 
lmpreguated" string in the path field. This means that the GRFS 
agent must replace the internal '\0' path delimeters with the 
agent's OS specific path delimeter character. No applause 
necessary. ^ 

The proper response message type is GRFS CHANGE DIR STAT. There 
are no parameters associated with this response "message . 
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3.18 GRFS_SET_OB J_INFO , GRFS_SET_OBJ_INFO_STAT 

The GRFS.SOT OBJ^INFO command is ueed by the backup application to 
set the file system attributes of a file system object The 
parameters associated with this command are described below: 

dle_id: This parameter contains the DLB handle id of the DLE 
where the object resides. 

dblk: This parameter is complete DBLK and contains the 

object type, the object name, and the object attribute 
data which are to be set. 

a5tribu1es: a9Gnt followin 9 fil * system object 

ctime (CREATION TIME) 

atime (ACCESS TIME) (if possible) 

tame (MODIFIED TIME) 

size (object data size) 

gen_attr (file system attribute flags) 

The proper response message type is GRFS SET OBJ INFO STAT There 
are no parameters associated with this resp'onse^message . 
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3.19 GRFS_VERIFY_OBJ_INFO, GRFS_VERIFY_OBJ_INFO_STAT 

The «»S_VBlUFTr_OBJ_IHFO command is used by the backup application 

^Jif^ 7 ^ fxle 8y v? tem object ^tributes on the GRFS^gen? 
match the ob 3 ect attributes contained on the backup media The 
parameters associated with this ccranand are described below: 

dle_id: This parameter contains the OLE handle of the DLE 

where the object resides. 6 DLB 

dblk: This parameter is a complete DBLK and contains the 

object type, the object name, and the object attribute 
data which are to be compared. 

The GRFS agent must verify that the following input parameter DBLK 
fields match the actual attributes of the file w« IKeSt: 

cdate (CREATION DATE) 

mdate (MODIFIED DATE) 

size (object data size) 

gen_attr (file system attribute flags) 

The proper response message type is GRFS VERIFY CRT INFO st&t 
There are no parameters associated with thi"s respond meSaTg7 ' 
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3.20 



GRFS_PRBPARB_DBLK, GRFS_PREPARE_DBLK_STAT 



The GRFS_PRBPARB_DBLK command is used so that during restore 
operations the GRFS Agent is able to modify <4nSe-? P ££ and 
directory names into a form which is usable b? ie taroet 
(restore) agent's file systems. Por instance, if abaSun sef il 
Cre ? t t d a ^ Int06h *9"*> then the file and directory names 
a-gent^ SfiSff £tt*%££r 25 *™ 

dl6 - id: wntre^e^ct^stdes.^ "* 1130316 ° f ^ DLB 

dblk: This parameter is a complete DBLK and contains the 

object type, the object name. cne 

Sd Sf U i 3a ? pend the . modified name at the end of the DBLK 

and alter the -os_" name pointers to point to the new name The 
agent must also modify the dblk. dblk actual size £Ta?co^nt fo? 
the increased DBLK size. If the input na^e does no^reouire 
modification, then the DBLK can be returned unmodified requxre 
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Appendix A - GRFS Technical Reference 

This section of the GRFS Technical Reference appendix shows 
^* < ^ u f 1 . definitions of the structures which have been 
described in this document. All of the structures can h» 
found the GRPS.H include file. structures can be 

typedef union 

{ 

INT8 val [4] ; 

INT32 num; 
} INET32; 

typedef union 
{ 

UINT8 val[4]; 
UINT32 num; 
} UNET32 ; 

typedef union 
{ 

IHT8 val [2 J ; 

INT16 num; 
} INET1C; 

typedef union 

UINT8 val[2]; 
UINT16 num; 
} UNET16; 

typedef struct 
{ 

UNET32 Ibw; 
UNET32 msv; 
} UNBT64; 

typedef UNET 32 DLE HANDLE ; 
typedef UNET32 OBJ HANDLE; 
typedef DNET32 REQ^HANDLB; 

GENERIC DBLK NETWORK STRUCTURE 

struct ^ grfs_gen_dblk_str 

UIOT8 blk_type; 

OTNT8 resl ; 

UINT8 fg_cora_reserve[38] ; 

struct STD OBJ INFO 
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{ 

UINT8 

UINT8 

UINT8 

DATEJTIME 

DATB_TIME 

DATE_TIME 

DATB^TIMK 

UNET64 

UNET32 

} std_info; 



OS_id; 

os Z ver ; 
res2t2] ; 
ctime; 
atiroe; 
btime ; 
time; 
size; 
gen_attr; 



BOOLE AN 

ONET16 

UNET16 

0NBT16 

UNET16 

UNET16 

UNST16 

UNET16 

UNET16 

DNET16 

BOOLEAN 

BOOLEAN 

UINT8 

union 

{ 



os_inf o_compiete ; 
min_ddb~inf o ; 
min^ddb^size ; 
os_spec_inf o ; 
os_spec_size ; 
dbl k_actual_s ire ; 
tape_attribl; 

name_coinplete ; 
f ind_info;~ 
f ind_inf o_s ize ; 
trans la te_f lag ; 
special_£lag; 
obj_type; 



struct OS_DDB_INFO 



{ 

UNET16 
UNET16 
UNET16 
DNET16 
} d; 

Struct OS_FDB_INFO 



os_path; 
osjpath_leng; 
path_leng; 
path! 



} b; 



{ 

BOOLEAN 

UNET16 

UNET16 

} f; 



inuse_attrib; 
os_name ; 



typedef struct 
*GRFS_GBN_DBLK_PTR ; 



struct grf sjmessage 



grxe_gen_dblk_str GRFS_GEN_DBLK, 



TJINT8 
UINT8 
UINT16 



msg_type; 
reserved; 
retcode; 
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UNET32 request_id 
union { 

/** GRF5 command parameter structures **/ 

DLE_HANDLE dle_id; 

OBJ_HANDLE obj_id; 

GRFS_ATTACH_DLE PARMS attach jparms ; 

GRFS_Fim)_FIRST~OBJ_PARMS ff_obj_parmB ; 

GRFS~OBJECT_PARMS ~ obj_parms; 

GRFS~OPEN_OBJJ?ARMS open_ob j _panns ; 

GRFS_READ_OBJ~PARMS read_ob j partus ; 

GRFS_WRITE_OB J_PARMS write_Ob3lp arinB ' 

GRFS_VERIFY_OB J_PARMS verif y_ob j jparme ; 

GRFS_SEBK_OBJ_PARMS seek objjparms; 

GRFS_CHANGE_DIR_PARMS change_di r_j>arms ; 

GRFS_ENDM_SPEC_PARMS enum_sp e c_parms ; 

/** GRFS response parameter structures **/ 

ONET32 seek obj offset; 

GRFSJ3EN_DBLK dblk? ~ 

GRFS_ATTACT_DI^_STAT_PARMS attach stat; 

GOTS_FIND_DLE_STAT_PARMS f ind_dle_stat ; 

GRFS^FIiiD^OBJ^STAT PARMS find_obj Stat; 

GRFS_OPEN_OB J_STAT~PARMS open_ob j_etat ; 

GRFS_READ_OBJ_STAT~PARMS read_obj_Btat ; 

GRFS_WRITB_OBJ_STAT_PARMS write_obj stat: 

GRFS_VERIFY_OBJ_STAT_PARMS verify obj stat; 

GRFS_EN0W_SPEC_STAT_PARMS enum_special_stat ; 
} msg^ parms ; 

}; 
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This section shows the GRFS command message types and their 
corresponding GRFS response message types. The parameters 
associated with each message are also provided. 



GRFS COMMAND MESSAGES 



GRFS RESPONSE MESSAGES 



GRFS_ATTACH_DLB ( dle_name [] , GRFS_ATTACH_DLE_STAT ( dle_id, 
bee_f lags , max_connects , 

special_word, max_opens_pe reconnect , 

max_ob j _bs ize, proces sddbs , ~ 

die jparent , max_ob j_bsize , 

onpr_ type , cmpr_type , 

user_name [] , support s_children 

password [] ) path JLen , 

current _path [] ) 

GRFS_FIND_FIRST_DLE ( dle_id) GRFS_FIND_DLE_STAT ( dlejoame [] , 

path_delim, 
passwd_req, 
user_req, 
dle_writeable , 
supports_last access, 
os_id, 
os_ver, 
{s_type, 
crypt_type , 
cmpr_type , 
more_ f lag) 

GRFS_FIND_NEXT_DLE ( dle_id) GRFS_FIND_DLE_STAT ( dle_name [] , 

path_delim, 
passwd_req, 
user^req, 
die writeable , 
os_id, 







os_ver, 
fs_type, 
crypt_type, 
cmpr_type, 
more~f lag) 




GRFS_DETACH_DLE ( 


dle_id) 


GRFS_DETACH_DLB_STAT ( 


-..) 


GRFS_FIND_FIRST_OBJ ( dle_id, 
f ind_type , 
sname [] ) 


GRFS_FIND_OBJ_STAT < 


more flag, 
dblkT 


GRFS FIND NEXT OBJ ( die, id, 
dblk) 


GRFS_FIND_OBJ_STAT ( 


more flag, 
dblkT 


GRFS_FIND_CLOSE ( 


die id, 
dblk) 


GRFS_FIND_CLOSB_STAT ( 




GRFS_CREATB_OBJ ( 


die id, 
dblk) 


GRFS_CREATB_OBJ_STAT ( 


---> 


GRFS_OPEN_OBJ ( 


dle_id, 
mode, 


GRFS_OPEN_OB J_STAT ( 


obj id, 
dblk) 
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dblk) 

GRFS_READ_OBJ ( obj_id, GRFS_READ_OB J_STAT ( size, 

size, ^ blk_size, 

offset) stnn_info, 

buffer [] ) 

GRFS_WRITE_OB J { obj_id, GRFS_WRITE_OB J_STAT ( size, 

size, ~ ~ blk_size) 

offset, 

strm_info, 

buffer!] ) 

GRFS SEBK_0BJ( obj id, GRFS SEEKJDBJ STAT( seek_obj_of f set) 
offset) 

GRFS_VERIFY_OBJ ( obj_id, GRFSJVERIFY_OBJ_STAT ( size, 

size, blk size) 

offset, "~ 
stnn_info, 
buffer [] ) 

GRFS_CL0SE_0BJ ( obj_id) GRFS_CL0SE_0B J_STAT ( ) 

GRFS_DELETE_OB J ( dle_id, GRFS_DELETB_OBJ STAT { ) 

dblk) 

GRFS_GET_0BJ_INFO(dle_id, GRFS_GET OBJ INFO STAT ( dblk) 
dblk) 

GRFS_VERIFY_OBJ_INF0 ( dle_id, GRFS VERIFY OBJ INFO STAT ( ) 

dblk) " " 

GRFS_CHANGE_DIR< dle_id, GRFS_CHANGE_DIR_STAT ( ) 

net_path [) , 
size) 

GRFS_GET_CUR_DDB ( dle_id_) GRFS_GET_CUR_DDB_STAT ( dblk) 

GRFS_SET_OBJ_INFO(dle_id, GRFS_SET OBJ INFO STAT ( ) 

dblk) " " 

GRFS_ENOM_SPECIAL_FIRST GRFS_ENOM_S PECXAL STAT ( name [] , 

"( dle_id, more_flag) 
enum_type) 

GRFS_ENUM_SPECIAlr_NEXT GRFS_ENUM_SPECIAL STAT( named, 

<dle_id, ~ more_flag) 

enum_type) 

GRFS_SPECIAL_EXCLUDE GRFS_S PECIAL_EXCLUDE_STAT ( ) 

(path_len, 
fname len, 
datat)) 

GRFS_PREPARB_DBIjK GRFS PREPARE DBLK STAT ( dblk) 

(dle_id, " " 

dblk) 
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COMMON GRFS MESSAGE PROCESSING 

All GRFS messages generated by the backup application include the 
following common fields: msg__type, retcode, and reguest_id. The 
me g_ type field must contain a valid GRFS command value. The 
backup application will set the reguest_id field to a value which 
the backup application will use to correlate outgoing GRFS command 
messages to the corresponding incoming GRFS response messages. 
The GRFS agent must set the requested value of the GRFS response 
message to the requested value received in the corresponding GRFS 
command message. The GRFS response message to the requested 
value received in the corresponding GRFS command message. The 
xet_code field is not used for GRFS command messages; it is 
meaningful only for GRFS response messages. 

Several of the message parameter structures contain large fields 
(DBliKs, full -path names) which are defined statically but contain 
variable length data, and these data fields will typically fill 
only a small portion of the allotted space. These large fields 
are always declared as the last member in the parameter structure. 
Only the portion of the message parameter field which is actually 
used must be transmitted across the network. This will allow the 
GRFS to be more efficient because most non object-data GRFS 
messages can be transmitted as a single NRL transport packet. 

CRITICAL ERROR HANDLING 

GRFS agent programs must handle critical error situations without 
hanging the agent's system. When a GRFS agent detects a critical 
error while performing an GRFS command, the agent program should 
"fail" the operation and set the retcode field appropriately 
( FS_DEVICE_ERROR , etc) . The agent can also retry the failed 
operation before returning a GRFS status message to the backup 
application. When a fatal FS error code is returned to the backup 
application, the application user will be given the opportunity to 
decide whether to retry the failed operation. 
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GRFS Messages Type Values 

. GRFS COMMANDS 



GRFS ATTACH JDLE 0x01 

GRFS_FIND_FIRST_DIiE 0x02 

GRFS_FIND_NEXT_DLE 0x03 

GRFS_DETACH_DLE 0x04 

GRFS_FIND_FIRST_OBJ 0x05 

GRFS_FIND_NEXT_OBJ 0x0 6 

GRFS_FIND_d0SE 0x07 

GRFS_CREATE OBJ 0x08 

GRFS OPEN_OBJ 0x09 

GRFS~READ_OBJ OxOA 

GRFS_WRITE_OBJ OxOB 

GRFS_SEEK_OBJ OxOC 

GRFS_VERIFY_OBJ OxOD 

GRFS_CLOSE_OBJ OxOE 

GRFS DELETE_OBJ OxOF 

GRFSJ3ET OBJ_INFO 0x10 

GRFS_VERIFY_OBJ_INFO Oxll 

GRFS_CHANGE_DIR 0x12 

GRFS~GET_CDR_DDB 0x13 

GRFS_SET_OBJ_INFO 0x14 

GRFS_ENUM_SPECIAL_FIRST 0x15 

GRFSJ3NUM_SPECIAL_NEXT 0x16 

GRFS_SPECIAL_EXCLUDE 0x17 

GRFS_PREPARE_DBI*K 0x18 



GRFS RESPONSES 

GRFS_ATTACH_DLE_STAT 
GRFS FIND_DLE_STAT 
GRFS~DETACH_DLB_STAT 
GRFS~FIND OBJ_STAT 
GRFS_FIND^CIiOSE_STAT 
GRFS_CREATE_OBJ_STAT 
GRFS_OPEN_OBJ_STAT 
GRFS_READ_OBJ_STAT 
GRFS_WRTTE_OBJ_STAT 
GRFS_SEEK_OBJ_STAT 
GRFS VERI FY_OB J_STAT 

grfs^closb^obj stat 
grfs_delete_obj_stat 
grfs~get obj_info_stat 
grfs~vbrxfy obj_info stat 
grfs_change~dir_stat~ 
grfsjget cor_ddb_stat 
grfs_set~obj_info_stat 
grfs enum_special_stat 
grfsjspecialjsxclude stat 

GRFS_PREPARE DBLK STAT 



0x41 
0x42 
0x44 
0x45 
0x47 
0x48 
0x49 
Ox4A 
0x4B 
Ox4C 
0x4D 
Ox4E 
0X4F 
0x50 
0x51 
0x52 
0x53 
0x54 
0x55 
0x57 
0x58 
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GRFS COMMAND MESSAGES 
GRFS ATTACH DLE 



GRFS_FIND_FIRST_DLE 
GRFS_FIND_NEXT_DLE 
GRFS_DETACH_DLE 
GRFS_FIND_FIRST_OBJ 



GRFS_FIND_NEXT_OBJ 

GRFS_FIND_CLOSE 

GRFS_CREATE_OBJ 

GRFS_DELETE_OBJ 

GRFS_GET_OBJ_INFO 

GRFS~VERIFY OBJ_INFO 

GRFS_SET_OBJ_INFO 

GRFS OPEN OBJ 



GRFS READ OBJ 



GRFS WRITE OBJ 



MESSAGE PARAMETER STRUCTURE 

struct GRFS_ATTACH_DLE_PARMS 

CHAR dle_name [GRFS_MAX_DLE_NAME_LEN] ; 

INBT16 bec_flags 
INET16 special_vord; 
UNET16 max obj_bsize; 

DLE_HANDLE die jparent ; 
UINTE8 cmp retype ; 

CHAR UBer_name [48] ; 

CHAR password [MAX_PASSOWRD LEN] ; 



}; 

DLE_HAND 
DLE_HAND 
DLE HAND 



dle_id; 
dle_id; 
die id; 



Struct GRFS_FIND_FIRST_OBJ_PARMS 

DLB_HAND die . id; 
UNET1 6 f ind_type ; 

CHAR sname [GRFS_MAX_SNAME] ; 
} * 

struct GRFS OBJECT PARMS 
{ 

DLE_HAND die id; 

GRFS_GEN_DBLK dblk; 
In- 



struct GRFS_OFBN_OBJ_PARMS 



{ 

DLE_HAKD 

INET16 

UNIT8 

GRFS GEN DBLK 

}; ~ - 



dle_id; 
mode; 

reserved [2] ; 
dblk; 



struct GRFS_READ_OBJ_PARMS 



{ 

OBJ_HAND 

UNET16 

UNET32 

}; 



obj_id; 

size; 

offset; 



struct GRFS WRITE OBJ PARMS 
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GRFS SEEK OBJ 



OBJ_HAND obj_id; 
DNET32 offset; 
STREAM_INFO strm_info; 
UNET16 size; 
UINT8 buffer [GRFS MIN OBJ SIZE] ; 
}; ~ " " 

struct GRFS SEEK OBJ PARMS 



{ 

OBJ_HAND 
UNET32 

}; 



obj_id; 
offset 



GRFS VERIFY OBJ 



GRFS_Ctt>SE_OBJ 
GRFS CHANGE DIR 



GRFS_BNUM_SPECIAL FIRST 
GRFS ENOM SPECIAiTnEXT 



struct GRFS VERIFY OBJ PARMS 

{ ~ ' ~. 

OBJ_HAND obj_id; 
UNBT32 offset; 
STREAM^ INFO stnn_info; 
DNET16 size; 
UINT8 buffer [GRFS MIN OBJ SIZE] ; 

}; " " " 

OBJ_HAND obj_id 

Struct GRFS CHANGE DIR PARMS 
{ - • - - 

DLE_HAND dle_id; 
INET16 size; 
CHAR net_path {GRFS_MAX_PA'TH_LEN] ; 

}; 

Struct GRFS ENUM SPEC PARMS 



{ 

DLE__HAND 
UNET16 

}; 



dle_id; 
enum_type ; 



GRFS SPECIAL EXCLUDE 



Struct GRFS SPEC EXCLUDE PARMS 
{ " ~ 

INET16 path_len ; 

INET16 fname_len ; 

UINT8 buffer [GRFS MIN OBJ SIZE] ; 

}; " " ' 
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GRFS RESPONSE MRggaregc; 
GRFS_ATTACH_DLE_STAT 



GRFS_FIND_DLE_STAT 



GRFS_DETACH_DLE_STAT 
GRFS_FIND_OBJ_STAT 



GRFS_FIND_CLOSE_STAT 
GRFS_CREATE_OBJ_STAT 
GRFSJ3PEN OBJ^STAT 



GRFS_READ_OBJ_STAT 



MESSAGE PARAMETER STRUCTURE 

Struct GRFS_ATTACH_DLE_STAT_PARMS 

DLB_HAND dle_id; 
INET16 max_connects ; 

INET16 max_open6_pe reconnect ; 

UNET16 process_ddbs; 
INET16 inax_obj_bsize; 
BOOLEAN support s_children ; 
UNET16 path_len 
UINT8 cmpr_type ; 

CHAR currentypath [GRFS_MAX_PATH_LEN] ; 

Struct GRFS_FIND_DLE_STAT_PARMS 

CHAR dle_name [GRFS_MAX_DLB_NAME_LENJ ; 

CHAR path_delim; 
UINT8 resl ; 

BOOLEAN passwd_req; 
BOOLEAN user_reg; 
BOOLEAN dle_writeable; 
BOOLEAN last_access_supported; 



INT8 
INT8 
INETX6 
UINT8 
UINT8 
BOOLEAN 

>; 



os_id; 
os_ver ; 
fs_type; 
crypt_type ; 
cmpr_type ; 
more_flag 



none 



Struct GRFS_FIND_OBJ_STAT_PARMS 



{ 

BOOLEAN 
UINT8 

GRFS GEN DBLK 

}; " " 



more_f lag; 
reseirved[2] ; 
dblk; 



none 
none 



Struct GRFS_OPEN_OBJ_STAT_PARMS 



{ 

OBJ HAND 
GRFS GEN DBLK 

}; ~ " 



obj.id; 
dblk; 



Struct ^ GRFS_READ_OBJ_STAT_PARMS 
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GRFS WRITE OBJ STAT 



GRFS_SEEK_OBJ_STAT 
GRFS VERIFY OBJ STAT 



GRFS_CLOSE_OBJ_STAT 

GRFS_DEIOTE_OBJ_STAT 

GRFS_GET_OBJ_INFO_STAT 

GRFS_VERIFY_OBJ_INFO_STAT 

GRFSJ3IANGE_DIR_STAT 

GRFS_GET_CUR_DDB_STAT 

GRFS_SET_OBJ_INFO_S , IAT 

GRFS_ENUM_SPECIAL_STAT 



UNET16 size; 
ONET16 blk_size; 
STR£AM_INFO strm_info; 
UIOT8 buffer [GRFS_MIN_OBJ_SIZE] ; 

}; 

Struct ^GRFS_WRITB_OBJ_STAT_PARMS 

UNET16 
UNET16 

}; 

0NET32 offset 



size; 
blk_size; 



struct GRFS_VERIFY_OBJ_STAT_PARMS 



{ 

UNBT16 
UNET16 

}; 

none 
none 

GRFS_GEN_DBLK 

none 

none 

GRFS_GEN_DBLK 
none 



size; 
blk_size; 



dblk; 



dblk; 



struct GRFS JBNUM_S PECIAIi_STAT_PARMS 

BOOLEAN more . flag ; 

INET1 6 path_len ; 

INET1G fname_len; 
UINT8 buffer [GRFS_MIN_OBJ_SIZE] ; 
} * 
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GRFS RETURN CODES 

The following values have been defined for GRFS agents to use as 
return codes in the retcode field of GRFS response messages: 

SUCCESS 0x0000 

OUT_OF_MEMORY OxFFFF 

FS_NEVE REATTACHED OxFBOl 

FS_BAD_DBLK 0XFE02 

FS_DIiE — NOT — ATTACHED 0xFE03 

FS_STACK__EMPTY 0xFE04 

FS_ACCESS_DENIED OxFEOS 

FS_OUT_OF~S PACE OxFEOG 

FS_NO_MORE 0xFE07 

FS_NOT_FOUND OxFEOS 

FS_INVALID_DIR OxFEOS 

FS~AT_ROOT OxFEOA 

FS_OBJECT_NOT_OPENED OxFEOB 

FS_EOF_REACHED OxFEOC 

FS~DEVTCB_ERROR OxFEOD 

FS~GDATA_DI FFERENT OxFEOE 

FS_SECURITY_DIFFERENT OxFEOF 

FS_OPBNED_INUSE OxFElO 

FS_IN_USE_ERROR OxFEll 

FS~INFO_piFFERENT 0xFE12 

FS_BUFFERjrO_SMALL 0xFB13 

FS_DEFADLT_SPECIFIED 0xFE14 

FS RE SDATA__D I FFERENT OxFE15 

FS_INCOMPATIBLE_OBJBCT 0xFE16 

FS_NOT_INITIALIZED 0xFE17 

FS_UNDEFINED_TYPE OxFElS 

FS_N0T_OPEN OxFEl9 

FS_INVALID_DIiE OxFElA 

FS_NO_MORBJDLE OxFElB 

FS~BAD_DLE_HAND OxFBIC 

FS_DRIVE_LI ST_ERROR OxFElD 

FS_ATTACHJTO_PARENT OxFElE 

FS_DEVI CE_NOT_FOUND OxFElF 

FS_BAD_INPOT_DATA 0xFE20 

FS_OS_ATTRIB~DI FFBR 0xFE2 1 

INVALID_PATH~DESCRIPTOR 0XFE22 

INVALID_FILBJ&BSCRIPTOR 0xFE23 

DRTVE_DES CR1 PTOR ERROR 0xFE24 

FS_lK)_MDRB_CONNECTIONS OxFE25 

FS_SBEVKR_ADDR_NDT FOUND 0xFE26 

FS_MAX_SERVER_CONNBCTIONS 0xFE27 

PS_BAD~ATIACH~TO_SERVER 0xFB2 8 

FS_BAD_SBRVERJLOGIN 0xFB29 

FS_SERVER_LOGOUT__DENIED 0XFE2A 

FS_BAD_ATTR_READ"" 0xFE2B 

FS~EADAXA_DIFFERENT 0xFB2C 

FS~OBJECT_CORRUPT 0xFE2D 

FS_ACLDATA_DI FFERENT 0xFB2B 

FS — CHILDREN NOT COMPLETE 0xFE2F 

FS~COMM_FAILORB~ 0xFE30 

FS~NET_DBV_BRROR 0xFE31 

FS_DONT_WANT_STREAM OxFEBl 
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The following section provides a list of likely return code values 
for each of the GRFS response messages. GRFS agents should use 
the return value listed above which provides the best indication 
for the cause of an error. 



GRFS_ATTACH_DLE STAT 

FS_ACCESS~DENIED 

FS_INVALID_DLE 
OUT_OF_MEMORY 

GRFS_FIND_DLB STAT 

" FS_INVALID DLE 
FS_NO_MQRE~ 

GRFS_DETACH_DLE_STAT 
FS_INVALID_DLE 

GRFS_FIND_OBJ_STAT 

FS_INVALID DIiE 
FS~NO MORS*" 



GRFS_FIND_CLOSE_STAT 
' FS_INVALID_DI*E 

GRFS_CREATE_OBJ STAT 
FS_INVALIDJDLB 
FS_DEVICE ERROR 



FS_ACCESS_DENIED 

FS_HAD_DBLK 

GRFS_OPEN_OBJ_STAT 

FS OPENED INUSE 



FS_IN_USEJERROR 



FS_INVALID_DLE 
FS_NOT FOUND 
FS_DEVICE_BRROR 

FS_BAD_DBLK 
FS_ACCESSJDENIED 

COT_OF_MEMORY 

GRFS_READ_GBJ_STAT 

FS_DEVTCE_BRROR 
FS OBJECT NOT OPENED 
FS~EOF REACHED 
FS ACCESS DENIED 



GRFS_WRITB_OBJ STAT 

FS OBOTJCT_NOT_OPENED 
FS DEVICE ERROR 



The user or password field was not 
valid. 

The dle_name was invalid 



dle_id was invalid 

No more DLBs to enumerate 



dle_id was invalid 



dle_id was invalid 

No more file system objects to 

enumerate 



dle_id was invalid 



dle_id was invalid 
"hard" device error 
c r e a 



to 
e 



unable 
t 

object 

Agent does not have permission to 

create object 

The DBLK data is invalid 



Object already opened by another 
process, but not locked, and 
B B C _ C ONFIG flag 
BBC_BACKOP_FILES_IN_USE is set 
Object already "opened by another 
proc es s and locked, 
BEC_BACKDP FILES IN USB not set 
dle_id was~invalid " 
Object not found 

"hard" device error, .unable to open 
object 

The DBLK data was invalid 

Agent does not have permission to 

open object 



"hard" device error read 
obj_id parameter was invalid 
End of File already reached 
Agent does not have permission to 
read object 



obj_id parameter not invalid 
"hard" device write error 
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FS_OBJECT_NOT_OPENED obj_id parameter was invalid 
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FS_OOT_OF_SPACE 
FS_ACCESS_DENIED 

FS_DONT_WANT_STREAM 



GRFS_SEEK_OB«J_STAT 

FS_OBJECT_NOT_OPENED 

FS_EOF_REACHED 

FS~DEVICE_ERROR 

GRFS_VERIFYJ3BJ_STAT 

FS_OBJECT_NOT_OPENED 
FS_DEVTCE_ERROR 
FS_EOF_ REACHED 
FS_GDATA__DI FFERENT 

FS_SECORITY_DIFFERENT 

FS_EADATA_D I FFERENT 

FS_DONT_WANT_STREAM 



GRFS_CLOSE_OBJ_STAT 

FS_OBJECr_NOT_OPENED 
FS_DEVX CE_ERROR 

GRFS_DELETE_OBJ_STAT 
FS_INVALID_DLB 
FS_NOT_FOUND 
FSJDKVX CE_ERROR 

FS_BAD_DBLK 
FS_ACCESS DENIED 



GRFS_GBT_OBJ_INFO_STAT 
FS INVALID_DLE 
FS~NO_MORE 
FS_DEVICEJSRROR 

FS_BAD_DBLK 

GRFS_VERIFY_OB«J INFO_STAT 
FS_INVALID_DLE 
FS_NOT_FOUND 
FS_DEVTCE_ERROR 

FS_BAD_DBLK 
FS_INFO_DIFFERENT 



GRFS_CHANGE DIR STAT 
FS_INVALID_DLB 
FS_INVALID_DIR 

FS_DEVICB_ERROR 



Device is full 

Agent does not have permission to 
write object 

Agent does not want to restore this 
data stream 



obj_id parameter was invalid 
End of File already reached 
"hard" device seek error 



obj_id parameter was invalid 
"hard" error 

End of File already reached 
Object's normal data stream does 
not match 

Object's security data stream does 
not match 

Object's extended attribute data 
stream does not match 
Agent does not support this data 
stream type 

obj_id parameter was invalid 
"hard" error 



dle_id was invalid 
Object not found 

"hard" device error, unable to 

delete object 

The DBLK data was invalid 

Agent does not have permission to 

delete object 



dle_id was invalid 
Object not found 

"hard" device error, unable to 

delete object 

The DBLK data was invalid 

dle_id was invalid 
Object not found 

"hard" device error, unable to scan 
device 

The DBLK data was invalid 

The object's attributes do not 

match 



dle_id was invalid 

net_path □ too long, or new path 

does not exist 

"hard" device error, unable to scan 
device 
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GRFS_GET_CUR_DDB_STAT 

FS_INVALID_DLE dle_id was invalid 

FS_DEVlCB_ERROR "hard" device error, unable to scan 

device 

GRFS_SBT_OBJ_INFO_STAT 

FS INVALID DLE die id was invalid 
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DBLK Pielric 

The individual fields within the GRFS common DBLK structure 
belw mUSt a^Pulated by GRFS agent programs are described 

blk_type: Defines whether the object is a file or a 

directory. 

files a 08 

directories = 09 

os_id; 

os_ver; 

ctime: 
atime : 
btime : 

time: These four fields are all defined as type DATE TIME 

structures. The DATEJTCME structure has the followina 
format: 3 

struct DATEJTIME { 

UINT16date_valid; /*TRUE or FALSE */ 

UINTlSyear; /*year since 1980 */ 

UINT16month; /* 1 to 12 */ 

UINT16day; /* x to 31 */ 

UINTlShour; /♦ 0 to 23 */ 

OTNT16minute; J* 0 to 59 */ 

UINT16second; */* 0 to 59 */ 

DINT1 6day_of _week ; /M to 7 Sun to Sat */ 

}; 

ctime = Object CREATION time 
atime * Object ACCESSED time 
btime * Object ARCHIVED time 
time = Object MODIFIED time 

If the OS of GRFS Agent, being developed does not 
support one or more of the specific time stamps, 
then those time stamp fields should be reset to 
all zeros. 

si?e: Th e oize field contains the size of the normal 

?? ta associated with the object. For instance 
the OS/2 Agent does NOT include the size of EAs 
and ACLs associated with an object. 

genattr: This field is a bit -mapped flag which describes 

the file system attributes of the object. The 
following flag values can be contained in this 
field: 

FILE_HORMAL 0x0 000 

FILB_READONLY 0 X0 0 0 1 

FILE — HIDDEN 0x0 002 

FILE~SYSTEM 0x0 0 04 

FILE_DIRBCTORY 0x0010 
FILB_ARCHIVED 0x0020 

os^info^complete This field is a boolean value which must be set 
to TRUE when the all the DBLK information for an 
object has been filled in. 
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mxn_ddb_info This field contains a pointer to the information 

in the DBLK data area which is required to 
perform either a GRFS_GET_OBJ_lNFO or 
GRFS_FIND_NEXT_OBJ command. The information 
pointed to by this field must be contiguous 
within the data area. Typically the DBLK *find 
information and the object name constitute the 
"MIN_DDB_INFO" . The DBLK find information is 
described in the find_info DBLK field. 

min_ddb_size This field contains the number of bytes of data 

pointed to by the min_ddb_info field. 

os_spec_info This field contains a pointer to the DBLK data 

area which contains any OS specific information 
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that the GRFS agent would like preserved during 
^u 0 ^?/^ restor ation operations. For instance 
the OS/2 agent uses this area to save HPFS "Long 
Names" when they are present. As another 
example, a Unix GRFS agent could use this field 
to save information about special device 
placeholder files. 

This field contains the number of bytes of data 
pointed to by the os_spec_info field. 

dblkactual_size This field contains the size of the entire DBLK 
This value is the sum of the size of the GRFS 
DBLK common structure and the number of bytes of 
data within the variable length DBLK data area. 
Remember that the total DBLK must at most 1024 
bytes long. 



os_spec_size 



tape_attribs 
find info 



find_info_size 
°bj_type 



not used 

^^nf t e i d contains a pointer to the information 
m DBLK data area which can be used by the GRFS 
agent to perform a GRFS_FIND_NEXT_OBJ command 
Examples of this field are the DOS GRFS agent 
passing a DTA structure and the OS/2 agent 
passing the DosFindFirstOHDIR value. 

This field contains the number of bytes of data 
pointed to by the find_info field. 

not used 



translate_flag not used 



special_flag 
b.d.os_path 



not used 

This field contains a pointer to the path string 
contained within the DBLK data area for a 
directory object. The path string should not 
begin with a path delimeter character unless it 
is the root directory of a DLB . The path string 
must be null -terminated. During backup 
operations the os_path field and the path field 
will be identical. During restore operations, 
the os_path field will represent the "source" 
path and the path field will represent the 
"destination" path. 

b.d.os_path_leng This field contains the. length of the path 
pointed to by the osjpath field. This value 
should include the null -termination character 



b.d.path_leng 



This field contains the length of the path 
pointed to by the path field. This value should 
include the null -termination character. 
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b.d.path This field contains a pointer to the path string 

contained within the DBLK data area for a 
directory object. The path string should not 
begin with a path delimeter character unless it 
is the root directory of a DLE. The path string 
must be null -terminated. During backup 

operations, the path field will be the same as 
the os_path field; however during restore 
operations the path field may be different than 
the os_path field. 

b,d.inuse_attrib This field contains a flag which is used to mark 
files which have been opened but the file is 
currently also opened by another process. 

b.f .osjoame This field contains a pointer to the file name 

string contained within the DBLK data area for 
a file object. The path string must be null- 
terminated. The os_name field and the name 
field will be the same during backup operations. 
During restore operations the os__name field 
represents the "source" file name whereas the 
name field represents the "destination" file 
name. 



b.f .name 



This field contains a pointer to the file name 
string contained within the DBLK data area for 
a file object. The path string must be null* 
terminated. 



Whenever a GRFS agent returns a DLE's logical root directory 
object DBLK, the DBLK data area path string should be set to 
'\0' and the b . d . os_path_leng field should be 1. 



55/1- 



SUBSTITUTE SHEET (RULE 26) 



WO J5/I3580 



PCI7US94/12915 



CLAIMS 

What is claimed is: 

1 1. A computer network, comprising: 

2 a) a plurality of computers running disparate 

3 operating systems, respectively; 

4 b) a storage device for backing up and 

5 restoring data processed on the network; and 

6 c) means for performing backup to and restore 

7 from the storage device, including: 

8 i) a GRFS file system running on one of 

9 the said computers; 

10 ii) a plurality of GRFS agents each 

11 running on a respective one of said computers; and 

12 i:Li > wherein said GRFS file system and 

13 each of said GRFS agents interface with one another via 

14 command and response messages, respectively, said command 

15 and response messages being structured to support the 

16 disparate operating systems. 

1 2. A computer network, according to claim l, 

2 wherein said disparate operating systems have different 

3 data structure alignments, and said command and response 

4 messages are structured with a least common denominator 

5 alignment for said disparate operating systems. 

1 3. A computer network, according to claim l, 

2 wherein said command and response messages are further 

3 structured to interchange data between said disparate 

4 operating systems. 
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1 4. A computer network, according to claim 3, 

2 wherein said interchange structure of said command and 

3 response messages enable data from one of said computers 

4 running one of said operating systems to backed up to 

5 said storage device and said backed up data to be 

6 restored to another of said computers running another of 

7 said disparate operating systems. 

1 5 . A computer network, according to claim 3, 

2 wherein said interchange structure of said messages 

3 includes a streamer header having an identification value 

4 determining whether an associated data stream type is 

5 supported by a given one of said disparate operating 

6 systems. 

1 6. A computer network, according to claim 1, 

2 wherein said command and response messages are further 

3 structured to enable independent multiple users of said 

4 plurality of computers to request simultaneously backup 

5 or restore of the data. 

1 7. A computer network, according to claim 6, 

2 wherein said command and response messages are structured 

3 with a request id and wherein said GRFS file system may 

4 create a unique request id for every GRFS command 

5 message, whereby the GRFS file system can communicate 

6 simultaneously with multiple GRFS agents. 

1 8. A computer network, according to claim 1, 

2 wherein said plurality of computers each has a user 

3 interface to enable a user to select backup or restore of 

4 selected data* 
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1 9. A computer network, according to claim l, 

2 wherein said network may have an additional computer not 

3 running a GRFS agent. 
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EXAMPLE 1: To bockup a single 5000 byte file 
Job Monooer Command Messgjj gs 



ATTACH_DLE( dle_nane = DougConpaq" 
dle_porent = NULL 
■ax_obj_bsize = 32768 . 

password = 'flpenSesone") 



MESSAGE ROW DIAGRAM FOR BACKUP 
GRFS Agent Workstation Response Messages 



"L 



FIND.FIRST.DLE( die. id = 01) 



ATTACHJ)LE_STAT( die. id = 01 

children = TRUE 
»°x_obj_bsize = 2048) 



u 



ATTACHJ)LE( dle.narae = "DriveC" 
dle.parent = 01 
nax_obj_bsize = 32768 
password = 'TO") 



FIND_FIRST_DLE.STAT( dle.none = "DriveC" 
posswd.req = TRUE) 



ATTACH.DLE.STAT( dle.id = 04 

children = FALSE 
«ox_obj.bsize = 2048) 



FIND.FIRST.OBJ( dle.id = 04 
snane ="*.»") 



FBC.0BJ.STAT( nore.f log = TRUE 
dblk (noue=COMMAND.COM)) 



0PEN_0BJ( dle.id = 04 

node = READ.ONLY 



n 



0PEN.0BJ.STAT( obj_id = 42 

dblk (nojie=C0MMAND.C0M)) 







READ.OBJ_STAT( size = 2048 

strnjeader = NORMALDATA 
buffer[] ) 


R£AD_0BJ( obj.id = 42 
size = 2048) 





READ.0BJ( objjd = 42 
size = 2048) 




READ_OBJ.STAT( size = 2048 

stri_heoder = INVALID 
buffer[] ) 


READ_OBJ( obj.id = 42 
size = 904 ) 








READ.0BJ.STAT( size = 904 

str»_header = INVALID 
bufferO ) 


CL0SE_0BJ( obj_id = 42)| 





FIM)_CL0SE( dle.id = 04 
dblk ) 




1 


DETACHJ)LE( dle.id = 04) 



CL0SE.0BJ.STAT ( ) 



FM)_CL0SE_STAT( ) 



DETACHJ)LE.STAT( ) 



DETACH_DLE( dle.id = 01) 



DETACHJ)LE.STAT( ) 



BNSOOCID: <WO__9S13580A1_I_> 



3/4 

SUBSTITUTE SHEET (RULE 26) 



FIG. 4 



WO 95/13580 



PCT/US94/12915 



EXAMPLE 2: To restore o single 5000 byte file. MESSAGE FLOW DIAGRAM FOR RESTORE 
Job Monoqer CoBnmndJejSoqes GRFS Agent Workstotion Response Messooes 



ATTACH_DLE( dle.nooie = 'DougConpoq" 
dle_porent = NULL 
nox.obj.bsize = 32768 
password = 'TJpenSesoiBe") 



ATTACH_DLE.STAT( dle.id = 01 

children = TRUE 
nox_obj.bsize = 2048) 



FIND.FIRST_DLE( dle.id = 01) 



ATTACH_DLE( dle.nane = "DriveC" 
dle_porent = 01 
inox_obj.bsize = 32768 
possword = *WOW!") 



FINDJ"IRSTJ)LE_$TAT( dle.nane = "DriveC" 
posswd.req = TRUE) 



PREPAREJ?BLK( dblk(none=CQNFIG.SYS)) 



ATTACH_DL£_STAT ( dle.id = 04 

children = FALSE 
max_obj_bsi*2e = 2048) 



GET.OBJECT.INFQ( db IkfnoB^QJflG^SJI^ ))! L|pR D>ARE JBLK_STAT( dblk (noi»e=C0NFIG.SYS)) 



CREATLOBJ( dblk(naae=KX)NFIG.SYS)) 



OPEH_0BJ( die id = 04 

node = WRITLONLY 
dblk (none=CONFIGiYS)) 



L- GET_OBJECTJNFO_STAT(dblk (noBe=CONFIG5YS)) 



WRITE_OBJ( obj_id = 42 
size = 2048 

strnjieoder = NORMAL.DATA 
buffer[] ) 



CREATE.OBJ.STAT ( ) 



OPEN_OBJ_STAT( obj.id = 42 

dblk (name=CONFIG.SYS)) 



WRITLOBJ.STAT( size = 2048 ) 



WRITE_0BJ( obj.id = 42 
size = 2048 
strn.heoder = MAUD 
bufferf] ) 



WRITLOBJ.STAT( size = 2048 ) 



WRITE_0BJ( obj.id = 42 
size = 904 

strn.heoder = INVALID 
buffer[] ) 



WRITE 08 J.STAT ( size = 904 ) 



CLOSE_OBJ( obj_idM2 



CL0SE_0BJ_STAT( ) 



SET.OBJECTJNFO( dblk(naiie=CONFIG^YS)) 



SET_0BJECTJNF0_STAT( ) 



(-»] DETACH_DLE_STAT( ) 



DETACH J)LE( dle.id = 04 



DETACH J)LE( dle.id = 01 



0ETACHJ)LE_STAT( ) 



FIG. 5 



4/4 
SUBSTITUTE SHEET (RULE 26) 



INTERNATIONAL SEARCH REPORT 



Inm aJ Appticwao No 

PCT/US 94/12915 



A. CLASSIFICATION OF SUBJECT MATTER 

IPC 6 606F11/14 



According to fntemaoonai Patent Classification (IPC) or to both national classification and IPC 



B. FIELDS SEARCHED 



Minimum documentation searched (classification system followed by classification symbols) 

IPC 6 G06F 



Documentation searched other than minimum documentation to the extent that such documents arc included in the fields 



searched 



Electronic data base consulted during the international search (name of data base and, where practical, search terms used) 



C DOCUMENTS CONSIDERED TO BE RELEVANT 



Category * Citation of document, with indication, where appropriate, of the relevant passages 



Relevant to claim No. 



IBM TECHNICAL DISCLOSURE BULLETIN, 
vol.35, no. 3, August 1992, NEW YORK US 
pages 286 - 289 

•Centralized and rapid backup/restore for 
Work LAN File Services/VM 1 
see the whole document 

US,A,5 005 122 (GRIFFIN ET AL.) 2 April , 
1991 

see abstract 

US,A,5 133 065 (CHEFFETZ ET AL.) 21 July 
1992 

see abstract 



1-8 



8 



□ 



Further < 



i arc listed in the continuation of box C 



|X I Patent family members arc listed in annex. 



Special categories of died docjUttCBtt : 

neral state of the art which is not 
to be of parti natar relevance 

*E" earner document but published on or after the intcmjoomJ 
filing date 

*L* document which may throw doubts on priority daixnXs) or 
which is cited to establish the publication date of another 
citation or other special reason (as specified) 
'O" document referring lo an oral disclosure, use, exhibition or 



T later 



filing data 



P* document published prior to the international filing date but 
later than the priority date claimed 



icnt published after the t 
_ date and not in conflict with the 
oted to understand the principle or theory 
invention 

"X" docum ent of particular relevance; the daimed invention 
cann ot be considered novel or cannot be considered to 
involve an inventive step when the document is taken i 

*Y" document of particula r relevance; the claimed mvcntion 
cannot be considered to involve an inventive step when the 
document is combined with one or more other such docu- 
ments, such cocaotnanon being obvious to a person skilled 
in the art. 

p of the same patent family 



Date of the actual completion of the mterrjanonal search 



9 March 1995 



Date of mailing of the international search report 



I7.i43.95 



Name and 



mailing address of the ISA 

European Patent Office, P.B. SSI t Patentlaan 2 
NL - 2210 HV Rj jrwijk 
Tel. (^31-70) 340-2040, TX 31 651 epo nt. 
Fax ( + 31-70) 340-3016 



Authorized officer 



Corremans, G 



Form PCT/ISA/210 (neons srmi) p«ly 1992) 



INTERNATIONAL SEARCH REPORT 

information on patent family ma ntel 



Intern; il Application No 

PCT/US 94/12915 



Patent document 
cited in search report 



Publication 
date 



Patent family 
mcmber(s) 



Publication 
date 



US-A-5005122 
US-A-5133065 



02-04-91 
21-07-92 



NONE 



NONE 



Fonn PCT/lSAvail (patent family 



■><J«iy im) 



This Page is Inserted by IFW Indexing and Scanning 
Operations and is not part of the Official Record 

BEST AVAILABLE IMAGES 

Defective images within this document are accurate representations of the original 
documents submitted by the applicant. 

Defects in the images include but are not limited to the items checked: 

dl BLACK BORDERS 

□ IMAGE CUT OFF AT TOP, BOTTOM OR SIDES 

□ FADED TEXT OR DRAWING 

□ BLURRED OR ILLEGIBLE TEXT OR DRAWING 

□ SKEWED/SLANTED IMAGES 

□ COLOR OR BLACK AND WHITE PHOTOGRAPHS 

□ GRAY SCALE DOCUMENTS 

□ LINES OR MARKS ON ORIGINAL DOCUMENT 

□ REFERENCE(S) OR EXHD3IT(S) SUBMITTED ARE POOR QUALITY 

□ OTHER: . 

IMAGES ARE BEST AVAILABLE COPY. 
As rescanning these documents will not correct the image 
problems checked, please do not report these problems to 
the IFW Image Problem Mailbox. 



